COSIMA · navidcy · Jun 16, 2025 · Jun 15, 2025 · Jun 15, 2025 · Jun 15, 2025
diff --git a/README.md b/README.md
@@ -12,11 +12,11 @@
 # COSIMA Cookbook
 
 This repository is a Cookbook of Recipes 👩🏽‍🍳 👨🏻‍🍳.
-A collection of recipes and tutorials for analysing ocean and sea ice model output produced by the [Consortium for Ocean-Sea Ice Modelling in Australia (COSIMA)](http://cosima.org.au/).
+A collection of cooking lessons and recipes for analysing ocean and sea ice model output produced by the [Consortium for Ocean-Sea Ice Modelling in Australia (COSIMA)](http://cosima.org.au/).
 
-We explain: a "recipe" here is an example of an analysis of some ocean-sea ice model output or some ocean-related observational datasets.
-Each "recipe" comes in a self-contained and well-documented Jupyter notebook.
-All the recipes combined form a cookbook 📒!
+We explain: a "cooking lesson" here is a tutorial that teaches you something generic (e.g. about plotting or loading data); a "recipe" is an example of an analysis of some ocean-sea ice model output or some ocean-related observational datasets.
+Both "cooking lessons" and "recipes" come in self-contained and well-documented Jupyter notebooks.
+All the lessons and the recipes combined form a cookbook 📒!
 
 Most recipes use output from the [ACCESS-OM2 model](https://doi.org/10.5194/gmd-13-401-2020), while some also use results from configurations of the [Modular Ocean Model 6 (MOM6)](https://github.com/mom-ocean/MOM6) and remote sensing observations.
 

diff --git a/...cific_Basin_Overturning_Circulation.ipynb → ...cific_Basin_Overturning_Circulation.ipynb b/...cific_Basin_Overturning_Circulation.ipynb → ...cific_Basin_Overturning_Circulation.ipynb
diff --git a/Recipes/Barotropic_Streamfunction.ipynb → ...sers-easy/Barotropic_Streamfunction.ipynb b/Recipes/Barotropic_Streamfunction.ipynb → ...sers-easy/Barotropic_Streamfunction.ipynb
diff --git a/Recipes/Compare_SSH_model_obs.ipynb → ...petisers-easy/Compare_SSH_model_obs.ipynb b/Recipes/Compare_SSH_model_obs.ipynb → ...petisers-easy/Compare_SSH_model_obs.ipynb
diff --git a/...ST_SSS_TemperatureSalinity_to_WOA13.ipynb → ...ST_SSS_TemperatureSalinity_to_WOA13.ipynb b/...ST_SSS_TemperatureSalinity_to_WOA13.ipynb → ...ST_SSS_TemperatureSalinity_to_WOA13.ipynb
diff --git a/Recipes/Hovmoller_Temperature_Depth.ipynb → ...rs-easy/Hovmoller_Temperature_Depth.ipynb b/Recipes/Hovmoller_Temperature_Depth.ipynb → ...rs-easy/Hovmoller_Temperature_Depth.ipynb
diff --git a/.../Meridional_Overturning_Circulation.ipynb → .../Meridional_Overturning_Circulation.ipynb b/.../Meridional_Overturning_Circulation.ipynb → .../Meridional_Overturning_Circulation.ipynb
diff --git a/Recipes/Model_Resolution_Comparison.ipynb → ...rs-easy/Model_Resolution_Comparison.ipynb b/Recipes/Model_Resolution_Comparison.ipynb → ...rs-easy/Model_Resolution_Comparison.ipynb
diff --git a/...es_and_Annually_Averaged_Timeseries.ipynb → ...es_and_Annually_Averaged_Timeseries.ipynb b/...es_and_Annually_Averaged_Timeseries.ipynb → ...es_and_Annually_Averaged_Timeseries.ipynb
diff --git a/Recipes/Relative_Vorticity.ipynb → .../appetisers-easy/Relative_Vorticity.ipynb b/Recipes/Relative_Vorticity.ipynb → .../appetisers-easy/Relative_Vorticity.ipynb
diff --git a/Recipes/Transport_Through_Straits.ipynb → ...sers-easy/Transport_Through_Straits.ipynb b/Recipes/Transport_Through_Straits.ipynb → ...sers-easy/Transport_Through_Straits.ipynb
diff --git a/Recipes/True_Zonal_Mean.ipynb → ...pes/appetisers-easy/True_Zonal_Mean.ipynb b/Recipes/True_Zonal_Mean.ipynb → ...pes/appetisers-easy/True_Zonal_Mean.ipynb
diff --git a/.../regional-mom6-forced-by-access-om2.ipynb → .../regional-mom6-forced-by-access-om2.ipynb b/.../regional-mom6-forced-by-access-om2.ipynb → .../regional-mom6-forced-by-access-om2.ipynb
diff --git a/Recipes/Along-slope-velocities.ipynb → ...ins-advanced/Along-slope-velocities.ipynb b/Recipes/Along-slope-velocities.ipynb → ...ins-advanced/Along-slope-velocities.ipynb
diff --git a/Recipes/Along_Isobath_Average.ipynb → ...ains-advanced/Along_Isobath_Average.ipynb b/Recipes/Along_Isobath_Average.ipynb → ...ains-advanced/Along_Isobath_Average.ipynb
diff --git a/Recipes/Cross-contour_transport.ipynb → ...ns-advanced/Cross-contour_transport.ipynb b/Recipes/Cross-contour_transport.ipynb → ...ns-advanced/Cross-contour_transport.ipynb
diff --git a/Recipes/Cross-slope_section.ipynb → .../mains-advanced/Cross-slope_section.ipynb b/Recipes/Cross-slope_section.ipynb → .../mains-advanced/Cross-slope_section.ipynb
diff --git a/...y-Mean_Kinetic_Energy_Decomposition.ipynb → ...y-Mean_Kinetic_Energy_Decomposition.ipynb b/...y-Mean_Kinetic_Energy_Decomposition.ipynb → ...y-Mean_Kinetic_Energy_Decomposition.ipynb
diff --git a/...hermal_and_zonal_velocity_structure.ipynb → ...hermal_and_zonal_velocity_structure.ipynb b/...hermal_and_zonal_velocity_structure.ipynb → ...hermal_and_zonal_velocity_structure.ipynb
diff --git a/...s/Extract_Variables_at_Ocean_Bottom.ipynb → ...d/Extract_Variables_at_Ocean_Bottom.ipynb b/...s/Extract_Variables_at_Ocean_Bottom.ipynb → ...d/Extract_Variables_at_Ocean_Bottom.ipynb
diff --git a/...ostrophic_Velocities_from_Sea_Level.ipynb → ...ostrophic_Velocities_from_Sea_Level.ipynb b/...ostrophic_Velocities_from_Sea_Level.ipynb → ...ostrophic_Velocities_from_Sea_Level.ipynb
diff --git a/Recipes/Horizontal_Regridding.ipynb → ...ains-advanced/Horizontal_Regridding.ipynb b/Recipes/Horizontal_Regridding.ipynb → ...ains-advanced/Horizontal_Regridding.ipynb
diff --git a/Recipes/Meridional_heat_transport.ipynb → ...-advanced/Meridional_heat_transport.ipynb b/Recipes/Meridional_heat_transport.ipynb → ...-advanced/Meridional_heat_transport.ipynb
diff --git a/Recipes/Nearest_Neighbour_Distance.ipynb → ...advanced/Nearest_Neighbour_Distance.ipynb b/Recipes/Nearest_Neighbour_Distance.ipynb → ...advanced/Nearest_Neighbour_Distance.ipynb
diff --git a/Recipes/Neutral_density.ipynb → Recipes/mains-advanced/Neutral_density.ipynb b/Recipes/Neutral_density.ipynb → Recipes/mains-advanced/Neutral_density.ipynb
diff --git a/Recipes/Particle_tracking_with_Parcels.ipynb → ...nced/Particle_tracking_with_Parcels.ipynb b/Recipes/Particle_tracking_with_Parcels.ipynb → ...nced/Particle_tracking_with_Parcels.ipynb
diff --git a/..._Area_Concentration_Volume_with_Obs.ipynb → ..._Area_Concentration_Volume_with_Obs.ipynb b/..._Area_Concentration_Volume_with_Obs.ipynb → ..._Area_Concentration_Volume_with_Obs.ipynb
diff --git a/Recipes/Sea_Ice_Coordinates.ipynb → .../mains-advanced/Sea_Ice_Coordinates.ipynb b/Recipes/Sea_Ice_Coordinates.ipynb → .../mains-advanced/Sea_Ice_Coordinates.ipynb
diff --git a/Recipes/Sea_Ice_Seasonality_Statistics.ipynb → ...nced/Sea_Ice_Seasonality_Statistics.ipynb b/Recipes/Sea_Ice_Seasonality_Statistics.ipynb → ...nced/Sea_Ice_Seasonality_Statistics.ipynb
diff --git a/...s/Surface_Water_Mass_Transformation.ipynb → ...d/Surface_Water_Mass_Transformation.ipynb b/...s/Surface_Water_Mass_Transformation.ipynb → ...d/Surface_Water_Mass_Transformation.ipynb
diff --git a/Recipes/Temperature_Salinity_Diagram.ipynb → ...vanced/Temperature_Salinity_Diagram.ipynb b/Recipes/Temperature_Salinity_Diagram.ipynb → ...vanced/Temperature_Salinity_Diagram.ipynb
diff --git a/...ion_from_Depth_to_Potential_Density.ipynb → ...ion_from_Depth_to_Potential_Density.ipynb b/...ion_from_Depth_to_Potential_Density.ipynb → ...ion_from_Depth_to_Potential_Density.ipynb
diff --git a/docs/conf.py b/docs/conf.py
@@ -55,6 +55,10 @@
 # a list of builtin themes.
 #
 # html_theme = 'default'
+html_theme_options = {
+    "sidebar_collapse": False,
+    "sidebar_includehidden": False,
+}
 
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,

diff --git a/docs/guidelines.rst b/docs/guidelines.rst
@@ -44,8 +44,7 @@ format for the other entries already in there.
 Images in notebooks
 -------------------
 
-If including external images (i.e. not plots generated in the code) in
+If including external images (i.e., not plots generated in the code) in
 notebooks, place them in the ``images/`` directory next to the
 notebook. Use the syntax ``![image caption](images/image.png)`` to
 include the image in the notebook.
-
diff --git a/docs/index.rst b/docs/index.rst
@@ -3,6 +3,7 @@
    You can adapt this file completely to your liking, but it should at least
    contain the root `toctree` directive.
 
+
 COSIMA Cookbook
 ===============
 
@@ -16,20 +17,18 @@ All the recipes combined form a cookbook 📒!
 
 Happy cooking! 😉 🥙 🍱 🍲
 
-To get started have a look at the tutorials_ and then browse through the
-available recipes_ to find something the better suits your 'taste' (i.e., your needs)!
-The  `COSIMA Cookbook tutorial`_ is perhaps the best place to start.
+To get started you should first take the :doc:`Cooking Lessons 101 <tutorials>` (i.e., our Tutorials).
+After you've gone through them and feel comfortable, browse through the
+available :doc:`recipes/index` (i.e., examples) to find something the better suits your 'taste' (i.e., your needs)!
 
-.. _tutorials: tutorials.html
-.. _recipes: recipes.html
-.. _COSIMA Cookbook tutorial: https://cosima-recipes.readthedocs.io/en/latest/Tutorials/COSIMA_CookBook_Tutorial.html
+The  :doc:`COSIMA Cookbook tutorial <Tutorials/COSIMA_CookBook_Tutorial>` is perhaps the best place to start.
 
 .. toctree::
-   :maxdepth: 1
+   :maxdepth: 2
    :caption: Contents:
 
    tutorials
-   recipes
+   recipes/index
    guidelines
    contributing
    GitHub Repository <https://github.com/cosima/cosima-recipes>

diff --git a/docs/recipes.rst b/docs/recipes.rst
diff --git a/docs/recipes/appetisers.rst b/docs/recipes/appetisers.rst
@@ -0,0 +1,9 @@
+Appetisers (easy)
+=================
+
+.. nbgallery::
+   :name: recipe-gallery-appetisers
+   :glob:
+   :hidden:
+
+   ../Recipes/appetisers-easy/*
diff --git a/docs/recipes/index.rst b/docs/recipes/index.rst
@@ -0,0 +1,13 @@
+Recipes
+=======
+
+The recipes are split into :doc:`appetisers` (i.e., easier/simpler recipes -- a good place
+to start after you've been through the :doc:`../tutorials`), :doc:`mains` (i.e. elaborate/advanced recipes)
+and :doc:`local-dishes` (i.e. recipes for regional configurations).
+
+.. toctree::
+   :maxdepth: 1
+
+   appetisers
+   mains
+   local-dishes
diff --git a/docs/recipes/local-dishes.rst b/docs/recipes/local-dishes.rst
@@ -0,0 +1,9 @@
+Local dishes (Regional configurations)
+======================================
+
+.. nbgallery::
+   :name: recipe-gallery-regional
+   :glob:
+   :hidden:
+
+   ../Recipes/local-dishes-regional/*
diff --git a/docs/recipes/mains.rst b/docs/recipes/mains.rst
@@ -0,0 +1,9 @@
+Main dishes (advanced)
+======================
+
+.. nbgallery::
+   :name: recipe-gallery-mains
+   :glob:
+   :hidden:
+
+   ../Recipes/mains-advanced/*
diff --git a/docs/tutorials.rst b/docs/tutorials.rst
@@ -1,8 +1,7 @@
-Tutorials
-=========
+Cooking lessons 101 (Tutorials)
+===============================
 
 .. nbgallery::
-   :caption: Tutorials
    :name: tutorial-gallery
    :glob:
    :hidden: