diff --git a/docs/source/explanation/index.md b/docs/source/explanation/index.md new file mode 100644 index 00000000..07dbcc86 --- /dev/null +++ b/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 + +``` diff --git a/docs/source/faq/index.md b/docs/source/faq/index.md new file mode 100644 index 00000000..82929a92 --- /dev/null +++ b/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 + +``` diff --git a/docs/source/howto/index.md b/docs/source/howto/index.md new file mode 100644 index 00000000..1a4d68a9 --- /dev/null +++ b/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 + +``` diff --git a/docs/source/index.md b/docs/source/index.md index 896a89b0..90649789 100644 --- a/docs/source/index.md +++ b/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 diff --git a/docs/source/tutorial/index.md b/docs/source/tutorial/index.md new file mode 100644 index 00000000..14d6f1b3 --- /dev/null +++ b/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 + +```