Categorise recipes + rename recipes and tutorials to dishes and cooking lessons

[navidcy]

@angus-g I tried to add subcategories to recipes in anticipation of #523 and moving towards #182.
But I failed... I did a few other attempts locally that also failed. Do you know how to achieve this?

I'm thinking that Recipes should have subcategories eg

Recipes
├─ Appetisers (easy)
├─ Mains (medium-to-hard)
└─ Local Dishes (regional setups)

Or if you figure how to set up the categorisation it'd be easy to tweak laters.

cc @julia-neme

[angus-g]

Sorry, a bit of fiddling around but this should give you an idea of how to do it.

[navidcy]

T H A N K S!

[navidcy]

@julia-neme, @adele-morrison, @edoddridge: could someone have a look/review?

A preview of the docs is found at https://cosima-recipes--529.org.readthedocs.build/en/529/

[navidcy]

I quickly did a split between mains and appetisers but I'm not strong about it! We can also change later.

[edoddridge]

My biggest concern with this is that the tutorials don't fit the menu analogy. I guess I would have expected them to be in the appetisers?

[navidcy]

How about:

• Appetisers (Tutorials; the place everybody should start)
• Small Dishes (Easy recipes)
• Mains (Advanced/Elaborate recipes)
• Local Cuisine (Regional configurations)

[chrisb13]

These categories are yummy! Thanks @navidcy and @angus-g.

This is off topic but could the docs be more visible somehow? Shamefully, today is the first time I've looked at it. I've always just read the README and then looked at tutorials etc. One option I guess is to move all the README content into the docs and only have a link to the docs on the README (reduces admin burden too). Just a thought.

[navidcy]

These categories are yummy! Thanks @navidcy and @angus-g.

This is off topic but could the docs be more visible somehow? Shamefully, today is the first time I've looked at it. I've always just read the README and then looked at tutorials etc. One option I guess is to move all the README content into the docs and only have a link to the docs on the README (reduces admin burden too). Just a thought.

But the README does link to the docs! All these are links to the docs:

[review-notebook-app]

Check out this pull request on 

See visual diffs & provide feedback on Jupyter Notebooks.

---

Powered by ReviewNB

[navidcy]

How about:

• Appetisers (Tutorials; the place everybody should start)
• Small Dishes (Easy recipes)
• Mains (Advanced/Elaborate recipes)
• Local Cuisine (Regional configurations)

If we are doing that we don't need subcategories, right? At the moment the "dishes" are under "Recipes" as a subcategory:

• Tutorials
• Recipes
  • Appetizers
  • Mains
  • Local

[chrisb13]

But the README does link to the docs! All these are links to the docs:

Yikes, mea culpa -- I totally missed that!

[navidcy]

But the README does link to the docs! All these are links to the docs:

Yikes, mea culpa -- I totally missed that!

A lot of people miss the docs or seem to have a tendency to avoid them and I don't know why!

[navidcy]

@edoddridge I renamed the Tutorials to "Cooking Lessons 101"; how's that?

[navidcy]

I think this PR is ready for review!

[edoddridge]

@edoddridge I renamed the Tutorials to "Cooking Lessons 101"; how's that?

Looks good to me. It fits the theme nicely.

[edoddridge]

LGTM

[edoddridge]

This is a nice catch - harmonising and simplifying the look. 👍

[navidcy]

:)

[navidcy]

I'll merge. If there is disagreements regarding a dish being a main while being put in the appetisers we can adjust later!