alchemistry · dotsdl · Feb 17, 2020 · Feb 17, 2020 · Feb 17, 2020
diff --git a/docs/conf.py b/docs/conf.py
@@ -30,11 +30,14 @@
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
-extensions = ['sphinx.ext.autodoc',
+extensions = [
+    'sphinx.ext.autodoc',
     'sphinx.ext.intersphinx',
     'sphinx.ext.mathjax',
     'sphinx.ext.autosummary',
-    'sphinx.ext.napoleon']
+    'sphinx.ext.napoleon',
+    'nbsphinx'
+    ]
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']
@@ -176,3 +179,5 @@
 
 # generate stub pages where directed with autosummary
 #autosummary_generate = True
+
+nbsphinx_allow_errors = True
diff --git a/docs/examples.rst b/docs/examples.rst
@@ -1,3 +1,9 @@
+.. _examples:
+
 Examples
 ========
 
+
+.. toctree::
+    :maxdepth: 1
+
diff --git a/docs/index.rst b/docs/index.rst
@@ -52,11 +52,20 @@ Contributions are very welcome. If you have bug reports or feature requests or q
 .. _`Issue Tracker`: https://github.com/alchemistry/alchemlyb/issues
 .. _`alchemistry/alchemlyb`: https://github.com/alchemistry/alchemlyb
 
+
 .. toctree::
     :maxdepth: 1
-    :caption: User Documentation
+    :caption: Getting Started
 
     install
+    tutorials
+    examples
+
+.. toctree::
+    :maxdepth: 1
+    :caption: Package Documentation
+
+    overview
     parsing
     preprocessing
     estimators

diff --git a/docs/overview.rst b/docs/overview.rst
@@ -0,0 +1,6 @@
+.. _overview:
+
+Overview of the alchemlyb library
+=================================
+
+Something
diff --git a/docs/tutorials.rst b/docs/tutorials.rst
@@ -0,0 +1,17 @@
+Tutorials
+=========
+
+Welcome to alchemlyb!
+If you are new to the library, this content is designed to get you up and running with the library as quickly as possible.
+
+The tutorials included here are intended to be run through in the order given below.
+They go to great lengths to explain what is being done, but may gloss over some technical details in order to prioritize pedagogical value.
+
+After learning the usage patterns in alchemlyb, you will likely find the :ref:`examples` useful for learning about more detailed use cases.
+If you desire more technical detail on the underlying components of the library, we advise you visit the :ref:`overview`.
+
+.. toctree::
+    :maxdepth: 1
+
+    tutorials/10-minutes-to-alchemlyb.ipynb
+    tutorials/Pandas-Fu.ipynb