more docs

jupyter-server · Mar 24, 2020 · 1b992cb · 1b992cb
1 parent 36eb1ab
commit 1b992cb
Show file tree

Hide file tree

Showing 7 changed files with 26 additions and 11 deletions.
diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst
@@ -61,8 +61,8 @@ To run the Python tests, use::
 
     pytest
 
-Building the Documentation
-==========================
+Building the Docs
+=================
 
 To build the documentation you'll need `Sphinx <http://www.sphinx-doc.org/en/master/>`_,
 `pandoc <https://pandoc.org/>`_ and a few other packages.

diff --git a/docs/source/contributors/team-meetings.rst b/docs/source/contributors/team-meetings.rst
@@ -0,0 +1,12 @@
+Team Meetings and Road Map
+==========================
+
+Many of the lead Jupyter Server developers meet weekly over Zoom. These meetings are open to everyone.
+
+To see when the next meeting is happening, watch this Github issue:
+
+https://github.com/jupyter/jupyter_server/issues/126
+
+Also check out Jupyter Server's roadmap where we track future plans for Jupyter Server:
+
+https://github.com/jupyter/jupyter_server/issues/127
diff --git a/docs/source/developers/basic-extension.rst b/docs/source/developers/basic-extension.rst
@@ -0,0 +1,2 @@
+Authoring a basic server extension
+==================================
diff --git a/docs/source/developers/configurable-extension.rst b/docs/source/developers/configurable-extension.rst
@@ -1,15 +1,12 @@
-Creating a configurable, Jupyter Server extension
-=================================================
+Authoring a configurable, server extension application
+======================================================
 
 Jupyter Server offers a base class, ``ExtensionApp``, for authoring configurable Jupyter Server extensions. This class handles most of the boilerplate code for setting up config, CLI, and registration with Jupyter Server.
 
 Writing an extension application
 --------------------------------
 
-Jupyter Server provides two key classes for writing a server extension:
-
-    - ``ExtensionApp``
-    - ``ExtensionHandlerMixin``
+Jupyter Server provides two key classes for writing a server extension: i) ``ExtensionApp`` and ii) ``ExtensionHandlerMixin``
 
 The ExtensionApp:
 

diff --git a/docs/source/developers/dependency.rst b/docs/source/developers/dependency.rst
@@ -16,4 +16,6 @@ To install the latest patch of a given version:
 
 To pin your jupyter_server install to a specific version:
 
+.. code-block:: console
+
     > pip install jupyter_server==1.0
diff --git a/docs/source/index.rst b/docs/source/index.rst
@@ -47,17 +47,19 @@ The Jupyter Server is a highly technical piece of the Jupyter Stack. Since most
    :name: developers
 
    developers/dependency
-   developers/frontends
+   developers/basic-extension
+   developers/configurable-extension
    developers/rest-api
+   changelog
 
 .. toctree::
    :caption: Contributors
    :maxdepth: 1
    :name: contributors
 
+   contributors/team-meetings
    contributors/contributing
 
-
 .. - Depending on Jupyter Server
 .. - Migrating a Notebook server extension to Jupyter Server
 .. - Writing a basic server extension from scratch

diff --git a/docs/source/users/configuration.rst b/docs/source/users/configuration.rst
@@ -3,7 +3,7 @@ Configuring a Jupyter Server
 
 By default, Jupyter Server looks for server-specific configuration in a ``jupyter_server_config.py|json`` file located on a Jupyter path. To list the possible paths, run:
 
-.. code-block:: bash
+.. code-block:: console
 
     > jupyter --paths
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,2 @@
		Authoring a basic server extension
		==================================
Original file line number	Diff line number	Diff line change
Expand Up		@@ -16,4 +16,6 @@ To install the latest patch of a given version:

		To pin your jupyter_server install to a specific version:

		.. code-block:: console

		> pip install jupyter_server==1.0