Cookbook
========

The cookbook is for short, task-oriented examples.

Unlike a tutorial, a cookbook is not primarily sequential. It is a place to
solve small, concrete problems such as:

* how to express a pipeline
* how to partially apply a function
* how to work with MRON or MRML
* how to use macros
* how to interoperate with a host ecosystem

How to use this section
-----------------------

Start with :doc:`common-recipes` for family-wide patterns.

Then move to implementation or format sections when the task depends on a
specific host or notation:

* MakrellPy recipes
* MakrellTS recipes
* Makrell# recipes
* MRON recipes
* MRML recipes

When the cookbook is the right tool
-----------------------------------

Use the cookbook when:

* you already know the rough area you are working in
* you want an example to adapt
* you do not need a full step-by-step introduction

If you are completely new to the family, start with :doc:`../getting-started`
or the :doc:`../tutorials/index` section first.

Reading strategy
----------------

A practical reading pattern is:

#. use a tutorial or quick-start page to understand the model
#. use cookbook pages to solve concrete tasks
#. return to concept or syntax pages when you need precise reference detail

.. toctree::
   :maxdepth: 2

   common-recipes
   choosing-recipes