Repository: dask/dask

Issue:
Promote setup documentation in Docs TOC
I suspect that the deploy page, https://docs.dask.org/en/latest/how-to/deploy-dask-clusters.html#, is of high enough importance that it should maybe get a top-level listing on the sidebar TOC.  Right now it's in the "How to" section at the same level as "How to set up prometheus", which seems less relevant. 


Discussion:
Fair enough. @jacobtomlinson and I are going to have some more docs time next week so we will make a plan of how dask and distributed docs should relate then. 
Checking in here.  From my perspective there should maybe be a "Deploy" or "Set up" top level entry that points to https://docs.dask.org/en/stable/how-to/deploy-dask-clusters.html
Yeah that's in the works as part of a large refactor of the distributed docs.

Resolving patch:
diff --git a/docs/source/conf.py b/docs/source/conf.py
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@@ -365,16 +365,26 @@
     ("cite.html", "faq.html#how-do-I-cite-dask"),
     ("remote-data-services.html", "how-to/connect-to-remote-data.html"),
     ("debugging.html", "how-to/debug.html"),
-    ("setup.html", "how-to/deploy-dask-clusters.html"),
-    ("setup/cli.html", "how-to/deploy-dask/cli.html"),
-    ("setup/cloud.html", "how-to/deploy-dask/cloud.html"),
-    ("setup/docker.html", "how-to/deploy-dask/docker.html"),
-    ("setup/hpc.html", "how-to/deploy-dask/hpc.html"),
-    ("setup/kubernetes.html", "how-to/deploy-dask/kubernetes.html"),
-    ("setup/python-advanced.html", "how-to/deploy-dask/python-advanced.html"),
-    ("setup/single-distributed.html", "how-to/deploy-dask/single-distributed.html"),
-    ("setup/single-machine.html", "how-to/deploy-dask/single-machine.html"),
-    ("setup/ssh.html", "how-to/deploy-dask/ssh.html"),
+    ("setup.html", "deploying.html"),
+    ("how-to/deploy-dask-clusters.html", "deploying.html"),
+    ("setup/cli.html", "deploying-cli.html"),
+    ("how-to/deploy-dask/cli.html", "deploying-cli.html"),
+    ("setup/cloud.html", "deploying-cloud.html"),
+    ("how-to/deploy-dask/cloud.html", "deploying-cloud.html"),
+    ("setup/docker.html", "hdeploying-docker.html"),
+    ("how-to/deploy-dask/docker.html", "deploying-docker.html"),
+    ("setup/hpc.html", "deploying-hpc.html"),
+    ("how-to/deploy-dask/hpc.html", "deploying-hpc.html"),
+    ("setup/kubernetes.html", "deploying-kubernetes.html"),
+    ("how-to/deploy-dask/kubernetes.html", "deploying-kubernetes.html"),
+    ("setup/python-advanced.html", "deploying-python-advanced.html"),
+    ("how-to/deploy-dask/python-advanced.html", "deploying-python-advanced.html"),
+    ("setup/single-distributed.html", "deploying-python.html"),
+    ("how-to/deploy-dask/single-distributed.html", "deploying-python.html"),
+    ("setup/single-machine.html", "scheduling.html"),
+    ("how-to/deploy-dask/single-machine.html", "scheduling.html"),
+    ("setup/ssh.html", "deploying-ssh.html"),
+    ("how-to/deploy-dask/ssh.html", "deploying-ssh.html"),
     ("setup/adaptive.html", "how-to/adaptive.html"),
     ("setup/custom-startup.html", "how-to/customize-initialization.html"),
     ("setup/environment.html", "how-to/manage-environments.html"),


Test patch: