Merge pull request #4301 from alwasega/create-folders

docs/source/explanation/index.md

@@ -0,0 +1,8 @@
+# Explanation
+
+The explanation guides are written to provide big-picture explanations of how JupyterHub works. They are meant to build your understanding of particular topics.
+
+```{toctree}
+:maxdepth: 2
+
+```

docs/source/faq/index.md

@@ -0,0 +1,8 @@
+# FAQs
+
+Find answers to some of the most frequently-asked questions around JupyterHub and how it works.
+
+```{toctree}
+:maxdepth: 2
+
+```

docs/source/howto/index.md

@@ -0,0 +1,8 @@
+# How-to
+
+The _How-to_ guides provide practical step-by-step details to help you achieve a particular goal. They are useful when you are trying to get something done but require you to understand and adapt the steps to your specific usecase.
+
+```{toctree}
+:maxdepth: 2
+
+```

docs/source/index.md

@@ -48,6 +48,18 @@ follows the Jupyter [Community Guides](https://jupyter.readthedocs.io/en/latest/
 
 ## Contents
 
+Documentation sections (reorganization in-progress)
+
+```{toctree}
+:maxdepth: 1
+
+faq/index.md
+tutorial/index.md
+howto/index.md
+explanation/index.md
+reference/index.md
+```
+
 (index/distributions)=
 
 ### Distributions

docs/source/tutorial/index.md

@@ -0,0 +1,8 @@
+# Tutorials
+
+This section of the documentation provides step-by-step tutorials to help you achieve a specific goal. The tutorials should be a good place to start learning about JupyterHub and how it works.
+
+```{toctree}
+:maxdepth: 2
+
+```