jupyterhub · yuvipanda · May 29, 2017 · May 25, 2017 · May 25, 2017 · May 25, 2017
diff --git a/doc/source/additional-resources.rst b/doc/source/additional-resources.rst
@@ -0,0 +1,4 @@
+Additional resources
+====================
+
+*Under development*
diff --git a/doc/source/backups.rst b/doc/source/backups.rst
@@ -0,0 +1,4 @@
+Backups
+=======
+
+*Under development*
diff --git a/doc/source/cost.rst b/doc/source/cost.rst
@@ -56,6 +56,6 @@ Data 8
 The Data 8 course at UC Berkeley used a JupyterHub to coordinate all course
 material and to provide a platform where students would run their code. This
 consisted of many hundreds of students, who had minimal requirements in terms
-of CPU and memory usage. Ryan Lovett put together
-`a short jupyter notebook <https://github.com/data-8/jupyterhub-k8s/blob/master/docs/cost-estimation/gce_budgeting.ipynb>`_
-estimating the cost for computational resources depending on the student needs.
+of CPU and memory usage. Ryan Lovett put together a short `Jupyter notebook
+estimating the cost for computational resources <https://github.com/data-8/jupyterhub-k8s/blob/master/docs/cost-estimation/gce_budgeting.ipynb>`_
+depending on the student needs.
diff --git a/doc/source/create-k8s-cluster.rst b/doc/source/create-k8s-cluster.rst
@@ -128,8 +128,6 @@ Setting up Kubernetes on Microsoft Azure Container Service (ACS)
           --resource-group=${RESOURCE_GROUP} \
           --name=${CLUSTER_NAME}
 
-
-
   where:
 
   * ``--resource-group`` specifies your Azure resource group.

diff --git a/doc/source/extending-jupyterhub.rst b/doc/source/extending-jupyterhub.rst
@@ -167,7 +167,7 @@ configure JupyterHub to build off of this image.
       The contents of your GitHub repository might not show up if you have enabled persistent storage. Disable persistent storage if you want them to show up!
 
 Pre-populating `$HOME` directory with notebooks when using Persistent Volumes
----------------------------------------------------------------------------
+-----------------------------------------------------------------------------
 
 By default, Persistent Volumes are used, so if you would like to include the contents of the github repository in the `$HOME` directory (e.g. all of the `*.ipynb` files), then edit ``config.yaml`` include these lines in it:
 

diff --git a/doc/source/index.rst b/doc/source/index.rst
@@ -16,24 +16,50 @@ questions, feel free to reach out at the `issues page`_.
 **Creating your JupyterHub**
 
 .. toctree::
-    :maxdepth: 2
+   :maxdepth: 2
 
-    getting-started
-    create-k8s-cluster
-    setup-helm
-    setup-jupyterhub
-    turn-off
+   getting-started
+   create-k8s-cluster
+   setup-helm
+   setup-jupyterhub
+   turn-off
 
-**Extra info and tips**
+**Customization Guide**
+
+JupyterHub can be configured and customized to fit a variety of deployment
+requirements. This guide helps outline how to customize and extend a JupyterHub
+deployment.
+
+.. toctree::
+   :maxdepth: 2
+
+   extending-jupyterhub
+   tools
+
+
+**Administrator Guide**
+
+This section provides information on managing and maintaining a staging or
+production deployment of JupyterHub.
+
+.. toctree::
+   :maxdepth: 2
+
+   resource-mgmt
+   cost
+   backups
+   upgrading
+   security-considerations
+   troubleshooting
+
+**Reference**
 
 .. toctree::
-    :maxdepth: 2
+   :maxdepth: 2
+
+   glossary
+   additional-resources
 
-    extending-jupyterhub
-    tools
-    troubleshooting
-    cost
-    glossary
 
 
 .. _JupyterHub: https://github.com/jupyterhub/jupyterhub

diff --git a/doc/source/resource-mgmt.rst b/doc/source/resource-mgmt.rst
@@ -0,0 +1,4 @@
+Resource management
+===================
+
+*Under development*
diff --git a/doc/source/security-considerations.rst b/doc/source/security-considerations.rst
@@ -0,0 +1,4 @@
+Security Considerations
+=======================
+
+*Under development*
diff --git a/doc/source/upgrading.rst b/doc/source/upgrading.rst
@@ -0,0 +1,4 @@
+Upgrading
+=========
+
+*Under development*