Merge pull request #319 from yuvipanda/digital-ocean-cloud

Move digital ocean 'resize' docs out of 'install' step
jupyterhub · May 10, 2019 · 1bf50d6 · 1bf50d6
2 parents 052df0b + b1c9a9f
commit 1bf50d6
Show file tree

Hide file tree

Showing 4 changed files with 53 additions and 40 deletions.
diff --git a/docs/howto/admin/resize.rst b/docs/howto/admin/resize.rst
@@ -13,13 +13,11 @@ the cloud provider of your choice.
 
 Currently there are instructions to resize your resources on the following providers:
 
-* :ref:`Digital Ocean <digitalocean/resize>`.
+* :ref:`Digital Ocean <howto/providers/digitalocean/resize>`.
 
 Once resources have been reallocated, you must tell TLJH to make use of these resources,
 and verify that the resources have become available.
 
-.. _tljhconf:
-
 Verifying a Resize 
 ==================
 

diff --git a/docs/howto/providers/digitalocean.rst b/docs/howto/providers/digitalocean.rst
@@ -0,0 +1,43 @@
+.. _howto/providers/digitalocean:
+
+================================================
+Perform common Digital Ocean configuration tasks
+================================================
+
+This page lists various common tasks you can perform on your
+Digital Ocean virtual machine.
+
+.. _howto/providers/digitalocean/resize:
+
+Resizing your droplet
+=====================
+
+As you use your JupyterHub, you may find that you need more memory, 
+disk space, or CPUs. Digital Ocean servers can be resized in the 
+"Resize Droplet" panel. These instructions take you through the process.
+
+#. First, click on the name of your newly-created
+   Droplet to enter its configuration page.
+
+#. Next, **turn off your Droplet**. This allows DigitalOcean to make
+   modifications to your VM. This will shut down your JupyterHub (temporarily).
+
+   .. image:: ../../images/providers/digitalocean/power-off.png
+      :alt: Power off your Droplet
+      :width: 200px
+
+#. Once your Droplet has been turned off, click "Resize",
+   which will take you to a menu with options to resize your VM.
+
+   .. image:: ../../images/providers/digitalocean/resize-droplet.png
+      :alt: Resize panel of digital ocean
+
+#. Decide what kinds of resources you'd like to resize, then click on a new VM
+   type in the list below. Finally, click "Resize". This may take a few moments!
+
+#. Once your Droplet is resized, **turn your Droplet back on**. This makes your JupyterHub
+   available to the world once again. This will take a few moments to complete.
+
+Now that you've resized your Droplet, you may want to change the resources available
+to your users. Further information on making more resources available to
+users and verifying resource availability can be found in :ref:`howto/admin/resize`. 
diff --git a/docs/index.rst b/docs/index.rst
@@ -95,6 +95,14 @@ Administration and security
    howto/admin/https
    howto/admin/enable-extensions
 
+Cloud provider configuration
+----------------------------
+
+.. toctree::
+   :titlesonly:
+   :caption: Cloud provider configuration
+
+   howto/providers/digitalocean
 
 Topic Guides
 ============

diff --git a/docs/install/digitalocean.rst b/docs/install/digitalocean.rst
@@ -116,40 +116,4 @@ Step 2: Adding more users
 Step 3: Install conda / pip packages for all users
 ==================================================
 
-.. include:: add_packages.txt
-
-.. _digitalocean/resize:
-
-Step 4: Resizing and editing the droplet
-========================================
-
-As you use your JupyterHub, you may find that you need more memory, 
-disk space, or CPUs. Digital Ocean servers can be resized in the 
-"Resize Droplet" panel. These instructions take you through the process.
-
-#. First, click on the name of your newly-created
-   Droplet to enter its configuration page.
-
-#. Next, **turn off your Droplet**. This allows DigitalOcean to make
-   modifications to your VM. This will shut down your JupyterHub (temporarily).
-
-   .. image:: ../images/providers/digitalocean/power-off.png
-      :alt: Power off your Droplet
-      :width: 200px
-
-#. Once your Droplet has been turned off, click "Resize",
-   which will take you to a menu with options to resize your VM.
-
-   .. image:: ../images/providers/digitalocean/resize-droplet.png
-      :alt: Resize panel of digital ocean
-
-#. Decide what kinds of resources you'd like to resize, then click on a new VM
-   type in the list below. Finally, click "Resize". This may take a few moments!
-
-#. Once your Droplet is resized, **turn your Droplet back on**. This makes your JupyterHub
-   available to the world once again. This will take a few moments to complete.
-
-Now that you've resized your Droplet, you may want to change the resources available
-to your users. Further information on making more resources available to
-users and verifying resource availability can be found in :ref:`howto/admin/resize`. 
-
+.. include:: add_packages.txt