diff --git a/docs/source/available_notebooks.rst b/docs/source/available_notebooks.rst
index 8123e3ed4a525822368a471b93befd8e300f1810..c2c883e17f7e3747d45c862452668b874b98f443 100644
--- a/docs/source/available_notebooks.rst
+++ b/docs/source/available_notebooks.rst
@@ -1,4 +1,4 @@
-.. available_notebooks:
+.. _available_notebooks:
 
 Available Notebooks
 ===================
diff --git a/docs/source/how_it_works.rst b/docs/source/how_it_works.rst
index 474990a873076a1efa21453f5d7aac726251c6a9..0b125cddfc2ecc20a6315e8108c5b6956bc31a6c 100644
--- a/docs/source/how_it_works.rst
+++ b/docs/source/how_it_works.rst
@@ -7,7 +7,7 @@ to expose Jupyter_ notebooks to a command line interface.
 Additionally, it leverages the DESY/XFEL Maxwell cluster to run these jobs in parallel
 via SLURM_.
 
-Here is a list of `available notebooks`_.
+Here is a list of `Available Notebooks`_.
 
 .. _nbparameterise: https://github.com/takluyver/nbparameterise
 .. _nbconver: https://github.com/jupyter/nbconvert
diff --git a/docs/source/index.rst b/docs/source/index.rst
index 0e52c89749bc54db2f62c654b1e41ecbfd87b363..f8f42748bdbfc6337331794a1766beb9de4499fa 100644
--- a/docs/source/index.rst
+++ b/docs/source/index.rst
@@ -11,9 +11,11 @@ Contents:
 .. toctree::
    :maxdepth: 2
    
+   how_it_works
    installation
    configuration
    workflow
+   availabe_notebooks
 
 
 
diff --git a/docs/source/installation.rst b/docs/source/installation.rst
index 91a2fece1b4a77f7e405a2e49203f1a431fc7ee1..b329b891faa827520197793037aff8f880345c82 100644
--- a/docs/source/installation.rst
+++ b/docs/source/installation.rst
@@ -39,5 +39,5 @@ all prerequisites and this tool chain by running::
 
     pip install -r requirements.txt .
     
-After installation, you should adjust the configuration_ and settings to
+After installation, you should adjust the :ref:`configuration` and settings to
 match your environment.
\ No newline at end of file
diff --git a/docs/source/workflow.rst b/docs/source/workflow.rst
index 5a7191c21e3c740abef1073ae3d431a81496f691..07536255fd92a7786aebce7c7b5be1001d35c6a8 100644
--- a/docs/source/workflow.rst
+++ b/docs/source/workflow.rst
@@ -294,7 +294,7 @@ launch a concurrent job and generate a report out of notebook. If it fails to ru
 normal Jupyter notebook environment, it will certainly fail in the tool chain environment.
 
 Once you are satisfied with your current state of initial development, you can add it
-to the list of notebooks as mentioned in the configuration_ section.
+to the list of notebooks as mentioned in the :ref:`configuration` section.
 
 Any changes you now make in the notebook will be automatically propagated to the command line.
 Specifically, you should verify that all arguments are parsed correctly, e.g. by calling::