add suggested review changes

.github/workflows/documentation.yml

@@ -117,6 +117,8 @@ jobs:
         run: |
           mkdir -p docs-repo/${{ steps.version-folder.outputs.folder }}
           cp -r sphinx-docs/* docs-repo/${{ steps.version-folder.outputs.folder }}
+          rm -rf docs-repo/${{ steps.version-folder.outputs.folder }}/.doctrees
+          rm -rf docs-repo/${{ steps.version-folder.outputs.folder }}/tutorial/*.ipynb
 
       - name: Push changes
         run: |

docs/advanced_topics/index.md

@@ -0,0 +1,13 @@
+---
+myst:
+  html_meta:
+    "description lang=en": |
+      Advanced topics describing specific workflows and functionalities
+---
+# Workflows
+
+```{toctree}
+../tutorial/6_binning_with_time-stamped_data
+../tutorial/7_correcting_orthorhombic_symmetry
+../tutorial/8_jittering_tutorial
+```

docs/index.md

@@ -30,6 +30,16 @@ Several example notebooks to demonstrate the functionality of SED for end-to-end
 workflows/index
 ```
 
+## Advanced topics
+
+There are also further example notebooks showing more advanced topics not required in every-day analysis.
+
+```{toctree}
+:maxdepth: 2
+
+advanced_topics/index
+```
+
 ## API
 
 ```{toctree}

docs/user_guide/index.md

@@ -15,7 +15,7 @@ installation
 ```{toctree}
 :caption: Basic concepts
 ../tutorial/1_binning_fake_data
-../tutorial/8_jittering_tutorial
+../tutorial/2_conversion_pipeline_for_example_time-resolved_ARPES_data
 ../tutorial/3_metadata_collection_and_export_to_NeXus
 ```
 

docs/workflows/index.md

@@ -7,8 +7,8 @@ myst:
 # Workflows
 
 ```{toctree}
-../tutorial/2_conversion_pipeline_for_example_time-resolved_ARPES_data
 ../tutorial/4_hextof_workflow
+../tutorial/8_jittering_tutorial
 ../tutorial/6_binning_with_time-stamped_data
 ../tutorial/7_correcting_orthorhombic_symmetry
 ```