PedestrianDynamics · schroedtert · Jan 25, 2026
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -114,7 +114,7 @@ jobs:
         with:
           name: demos_usage
           path: |
-            notebooks/
+            docs/source/notebooks/
 
   test:
     needs: build

diff --git a/.gitignore b/.gitignore
@@ -316,10 +316,9 @@ cython_debug/
 *.code-workspace
 
 docs/build
-docs/source/results_introduction
+**/results_introduction/
 docs/jupyter_execute
 pedpy/_version.py
 docs/source/ZENODO.rst
-notebooks/results_introduction
 # End of https://www.toptal.com/developers/gitignore/api/python,visualstudiocode,pycharm,jupyternotebooks
 .vscode
diff --git a/docs/source/_static/icon_analysis.svg b/docs/source/_static/icon_analysis.svg
diff --git a/docs/source/_static/icon_fd.svg b/docs/source/_static/icon_fd.svg
diff --git a/docs/source/_static/icon_fd_at_line.svg b/docs/source/_static/icon_fd_at_line.svg
diff --git a/docs/source/_static/icon_measurement_setup.svg b/docs/source/_static/icon_measurement_setup.svg
diff --git a/docs/source/_static/icon_preprocessing.svg b/docs/source/_static/icon_preprocessing.svg
diff --git a/docs/source/_static/icon_working_with_results.svg b/docs/source/_static/icon_working_with_results.svg
diff --git a/docs/source/_static/user_guide_flow.svg b/docs/source/_static/user_guide_flow.svg
diff --git a/docs/source/demo-data b/docs/source/demo-data
diff --git a/docs/source/fundamental_diagram.ipynb b/docs/source/fundamental_diagram.ipynb
diff --git a/docs/source/fundamental_diagram_at_measurement_line.ipynb b/docs/source/fundamental_diagram_at_measurement_line.ipynb
diff --git a/docs/source/getting_started.ipynb b/docs/source/getting_started.ipynb
diff --git a/docs/source/index.rst b/docs/source/index.rst
@@ -6,10 +6,9 @@ PedPy: Pedestrian Trajectory Analyzer
    :maxdepth: 1
    :hidden:
 
-   Getting Started <getting_started>
-   User Guide <user_guide>
+   Getting Started <notebooks/getting_started>
+   User Guide <user_guide/index>
    API Reference <api/index>
-   Methods <methods/index>
    Developer Guide <developer_guide>
    Cite PedPy <citation>
    Changelog <changelog>
@@ -52,7 +51,7 @@ Cite PedPy
     .. grid-item-card:: Getting Started
         :img-top: _static/getting_started.svg
         :class-card: intro-card
-        :link: getting_started
+        :link: notebooks/getting_started
         :link-type: doc
         :link-alt: To the getting started guide
 
@@ -62,7 +61,7 @@ Cite PedPy
     .. grid-item-card:: User Guide
         :img-top: _static/user_guide.svg
         :class-card: intro-card
-        :link: user_guide
+        :link: user_guide/index
         :link-type: doc
         :link-alt: To the user guide
 

diff --git a/docs/source/methods/index.rst b/docs/source/methods/index.rst