COSIMA · navidcy · Jun 19, 2025 · Jun 19, 2025 · Jun 19, 2025 · Jun 19, 2025
diff --git a/.github/workflows/sphinx.yml b/.github/workflows/sphinx.yml
@@ -30,5 +30,5 @@ jobs:
       - name: Ensure sphinx builds (warnings allowed)
         run: |
           cp -r Recipes/ docs/
-          cp -r Tutorials/ docs/
+          cp -r Cooking-Lessons-101-Tutorials/ docs/
           make -C docs html O=-n
diff --git a/.gitignore b/.gitignore
@@ -5,7 +5,7 @@ local_cc_test.db-journal
 dask-worker-space/
 
 docs/_build/
-docs/DocumentedExamples/
-docs/Tutorials/
+docs/Recipes/
+docs/Cooking-Lessons-101-Tutorials/
 
 **/SWMT_temp/
diff --git a/.readthedocs.yml b/.readthedocs.yml
@@ -13,7 +13,7 @@ build:
   jobs:
     post_checkout:
       - cp -r Recipes/ docs/
-      - cp -r Tutorials/ docs/
+      - cp -r Cooking-Lessons-101-Tutorials/ docs/
 
 python:
   install:

diff --git a/Tutorials/ACCESS-NRI_Intake_Catalog.ipynb → ...Tutorials/ACCESS-NRI_Intake_Catalog.ipynb b/Tutorials/ACCESS-NRI_Intake_Catalog.ipynb → ...Tutorials/ACCESS-NRI_Intake_Catalog.ipynb
diff --git a/Tutorials/Animations_with_xmovie.ipynb → ...01-Tutorials/Animations_with_xmovie.ipynb b/Tutorials/Animations_with_xmovie.ipynb → ...01-Tutorials/Animations_with_xmovie.ipynb
diff --git a/...s/Apply_function_to_every_gridpoint.ipynb → ...s/Apply_function_to_every_gridpoint.ipynb b/...s/Apply_function_to_every_gridpoint.ipynb → ...s/Apply_function_to_every_gridpoint.ipynb
diff --git a/Tutorials/COSIMA_CookBook_Tutorial.ipynb → ...-Tutorials/COSIMA_CookBook_Tutorial.ipynb b/Tutorials/COSIMA_CookBook_Tutorial.ipynb → ...-Tutorials/COSIMA_CookBook_Tutorial.ipynb
diff --git a/Tutorials/Make_Your_Own_Database.ipynb → ...01-Tutorials/Make_Your_Own_Database.ipynb b/Tutorials/Make_Your_Own_Database.ipynb → ...01-Tutorials/Make_Your_Own_Database.ipynb
diff --git a/...ials/Make_Your_Own_Intake_Datastore.ipynb → ...ials/Make_Your_Own_Intake_Datastore.ipynb b/...ials/Make_Your_Own_Intake_Datastore.ipynb → ...ials/Make_Your_Own_Intake_Datastore.ipynb
diff --git a/Tutorials/Making_Maps_with_Cartopy.ipynb → ...-Tutorials/Making_Maps_with_Cartopy.ipynb b/Tutorials/Making_Maps_with_Cartopy.ipynb → ...-Tutorials/Making_Maps_with_Cartopy.ipynb
diff --git a/Tutorials/Model_Agnostic_Analysis.ipynb → ...1-Tutorials/Model_Agnostic_Analysis.ipynb b/Tutorials/Model_Agnostic_Analysis.ipynb → ...1-Tutorials/Model_Agnostic_Analysis.ipynb
diff --git a/Cooking-Lessons-101-Tutorials/README.rst b/Cooking-Lessons-101-Tutorials/README.rst
@@ -0,0 +1,9 @@
+‼️ ⚠️ **Warning** ⛔️ 🚨
+
+Seems that you are about to view a cooking lesson (i.e. a tutorial) using Github's native Jupyter notebook viewer...
+
+This is **NOT** the best way to view a recipes or cooking lessons; you won't be getting the best possible experience via Github's native Jupyter notebook viewer.
+
+We'd strongly urge you to browse through the recipes or cooking lessons is via the website:
+
+https://cosima-recipes.readthedocs.io/en/latest/cooking-lessons-101.html
diff --git a/Tutorials/Spatial_selection.ipynb → ...ons-101-Tutorials/Spatial_selection.ipynb b/Tutorials/Spatial_selection.ipynb → ...ons-101-Tutorials/Spatial_selection.ipynb
diff --git a/...ls/Submitting_analysis_jobs_to_gadi.ipynb → ...ls/Submitting_analysis_jobs_to_gadi.ipynb b/...ls/Submitting_analysis_jobs_to_gadi.ipynb → ...ls/Submitting_analysis_jobs_to_gadi.ipynb
diff --git a/Tutorials/Template_For_Notebooks.ipynb → ...01-Tutorials/Template_For_Notebooks.ipynb b/Tutorials/Template_For_Notebooks.ipynb → ...01-Tutorials/Template_For_Notebooks.ipynb
diff --git a/Tutorials/Using_Explorer_tools.ipynb → ...-101-Tutorials/Using_Explorer_tools.ipynb b/Tutorials/Using_Explorer_tools.ipynb → ...-101-Tutorials/Using_Explorer_tools.ipynb
diff --git a/...intake_to_dask_efficiently_chunking.ipynb → ...intake_to_dask_efficiently_chunking.ipynb b/...intake_to_dask_efficiently_chunking.ipynb → ...intake_to_dask_efficiently_chunking.ipynb
diff --git a/Tutorials/movie_sst.gif → Cooking-Lessons-101-Tutorials/movie_sst.gif b/Tutorials/movie_sst.gif → Cooking-Lessons-101-Tutorials/movie_sst.gif
diff --git a/README.md b/README.md
@@ -45,11 +45,11 @@ Hence, users who put together a pull request for a new contribution, should ensu
 
 ## Contents
 
-### [Tutorials](https://cosima-recipes.readthedocs.io/en/latest/tutorials.html)
+### [Cooking Lessons 101 (Tutorials)](https://cosima-recipes.readthedocs.io/en/latest/cooking-lessons-101.html)
 
-The starting point should be the [COSIMA_CookBook_Tutorial](https://cosima-recipes.readthedocs.io/en/latest/Tutorials/COSIMA_CookBook_Tutorial.html) that showcases how we can use Intake catalog to interrogate about available output and load them. The [ACCESS-NRI_Intake_Catalog](https://cosima-recipes.readthedocs.io/en/latest/Tutorials/ACCESS-NRI_Intake_Catalog.html) tutorial outlines the basic philosophy of the Intake catalog and how to transition from using the deprecated `cosima_cookbook`-way of loading variables. (If this 👉 `cosima_cookbook.getvar` means nothing to you then don't worry, it's already deprecated and you are better off not learning what that is in the first place!)
+The starting point should be the [COSIMA_CookBook_Tutorial](https://cosima-recipes.readthedocs.io/en/latest/Cooking-Lessons-101-Tutorials/COSIMA_CookBook_Tutorial.html) that showcases how we can use Intake catalog to interrogate about available output and load them. The [ACCESS-NRI_Intake_Catalog](https://cosima-recipes.readthedocs.io/en/latest/Cooking-Lessons-101-Tutorials/ACCESS-NRI_Intake_Catalog.html) tutorial outlines the basic philosophy of the Intake catalog and how to transition from using the deprecated `cosima_cookbook`-way of loading variables. (If this 👉 `cosima_cookbook.getvar` means nothing to you then don't worry, it's already deprecated and you are better off not learning what that is in the first place!)
 
-Also included here are some other tutorials, related to techniques (e.g., [Making_Maps_with_Cartopy.ipynb](https://cosima-recipes.readthedocs.io/en/latest/Tutorials/Making_Maps_with_Cartopy.html)) or tools (e.g., [Model Agnostic Analysis](https://cosima-recipes.readthedocs.io/en/latest/Tutorials/Model_Agnostic_Analysis.html)).
+Also included here are some other tutorials, related to techniques (e.g., [Making_Maps_with_Cartopy.ipynb](https://cosima-recipes.readthedocs.io/en/latest/Cooking-Lessons-101-Tutorials/Making_Maps_with_Cartopy.html)) or tools (e.g., [Model Agnostic Analysis](https://cosima-recipes.readthedocs.io/en/latest/Cooking-Lessons-101-Tutorials/Model_Agnostic_Analysis.html)).
 
 
 ### [Recipes](https://cosima-recipes.readthedocs.io/en/latest/recipes.html)
@@ -82,4 +82,3 @@ We request that users of ACCESS-OM2 model [code](https://github.com/access-nri/a
 If you use a recipe from the Cookbook for your research or teaching, or have based your analysis on one of the recipes, we would be grateful if you could cite:
 
 [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.14353852.svg)](https://doi.org/10.5281/zenodo.14353852)
-
diff --git a/Recipes/README.rst b/Recipes/README.rst
@@ -1,4 +1,9 @@
-Documented Examples
-===================
+‼️ ⚠️ **Warning** ⛔️ 🚨
 
-These are some examples of what you can do with the COSIMA Cookbook
+Seems that you are about to view a recipe using Github's native Jupyter notebook viewer...
+
+This is **NOT** the best way to view a recipe; you won't be getting the best possible experience via Github's native Jupyter notebook viewer.
+
+We'd strongly urge you to browse through the recipes is via the website:
+
+https://cosima-recipes.readthedocs.io/en/latest/recipes/index.html
diff --git a/Tutorials/README.rst b/Tutorials/README.rst
diff --git a/docs/conf.py b/docs/conf.py
@@ -45,7 +45,7 @@
 exclude_patterns = [
     '_build', 'Thumbs.db', '.DS_Store',
     'Recipes/README.rst', 'Tutorials/README.rst',
-    'Tutorials/Template_For_Notebooks.ipynb'
+    'Cooking-Lessons-101-Tutorials/Template_For_Notebooks.ipynb'
 ]
 
 
@@ -66,9 +66,9 @@
 
 nbsphinx_execute = "never"
 nbsphinx_thumbnails = {
-    "Tutorials/ACCESS-NRI_Intake_Catalog": "_static/thumbnails/intake.png",
-    "Tutorials/Make_Your_Own_Database": "_static/thumbnails/database.png",
-    "Tutorials/Submitting_analysis_jobs_to_gadi": "_static/thumbnails/gadi.png",
-    "Tutorials/Using_Explorer_tools": "_static/thumbnails/explore.png",
-    "Tutorials/COSIMA_CookBook_Tutorial": "_static/thumbnails/cookbook.png",
+    "Cooking-Lessons-101-Tutorials/ACCESS-NRI_Intake_Catalog": "_static/thumbnails/intake.png",
+    "Cooking-Lessons-101-Tutorials/Make_Your_Own_Database": "_static/thumbnails/database.png",
+    "Cooking-Lessons-101-Tutorials/Submitting_analysis_jobs_to_gadi": "_static/thumbnails/gadi.png",
+    "Cooking-Lessons-101-Tutorials/Using_Explorer_tools": "_static/thumbnails/explore.png",
+    "Cooking-Lessons-101-Tutorials/COSIMA_CookBook_Tutorial": "_static/thumbnails/cookbook.png",
 }
diff --git a/docs/cooking-lessons-101.rst b/docs/cooking-lessons-101.rst
@@ -0,0 +1,9 @@
+Cooking Lessons 101 (Tutorials)
+===============================
+
+.. nbgallery::
+   :name: cooking-lessons-101-gallery
+   :glob:
+   :hidden:
+
+   Cooking-Lessons-101-Tutorials/*
diff --git a/docs/index.rst b/docs/index.rst
@@ -17,17 +17,17 @@ All the recipes combined form a cookbook 📒!
 
 Happy cooking! 😉 🥙 🍱 🍲
 
-To get started you should first take the :doc:`Cooking Lessons 101 <tutorials>` (i.e., our Tutorials).
+To get started you should first take the :doc:`Cooking Lessons 101 <cooking-lessons-101>` (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)!
 
-The  :doc:`COSIMA Cookbook tutorial <Tutorials/COSIMA_CookBook_Tutorial>` is perhaps the best place to start.
+The  :doc:`COSIMA Cookbook tutorial <Cooking-Lessons-101-Tutorials/COSIMA_CookBook_Tutorial>` is perhaps the best place to start.
 
 .. toctree::
    :maxdepth: 2
    :caption: Contents:
 
-   tutorials
+   cooking-lessons-101
    recipes/index
    guidelines
    contributing

diff --git a/docs/recipes/appetisers.rst b/docs/recipes/appetisers.rst
@@ -6,4 +6,4 @@ Appetisers (easy)
    :glob:
    :hidden:
 
-   ../Recipes/appetisers-easy/*
+   ../Recipes/Appetisers-Easy/*
diff --git a/docs/recipes/index.rst b/docs/recipes/index.rst
@@ -2,7 +2,7 @@ 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)
+to start after you've been through the :doc:`../cooking-lessons-101`), :doc:`mains` (i.e. elaborate/advanced recipes)
 and :doc:`local-dishes` (i.e. recipes for regional configurations).
 
 .. toctree::

diff --git a/docs/recipes/local-dishes.rst b/docs/recipes/local-dishes.rst
@@ -6,4 +6,4 @@ Local dishes (Regional configurations)
    :glob:
    :hidden:
 
-   ../Recipes/local-dishes-regional/*
+   ../Recipes/Local-Dishes-regional/*
diff --git a/docs/recipes/mains.rst b/docs/recipes/mains.rst
@@ -6,4 +6,4 @@ Main dishes (advanced)
    :glob:
    :hidden:
 
-   ../Recipes/mains-advanced/*
+   ../Recipes/Mains-Advanced/*
diff --git a/docs/tutorials.rst b/docs/tutorials.rst