Shared Concepts
===============

Makrell is easiest to understand when you separate the shared conceptual model
from the details of any single implementation.

These pages explain what is common across the family, while also being clear
about where individual implementations differ.

What this section covers
------------------------

The shared concepts section is the right place to learn about:

* the family-level structure behind MBF, the languages, and the formats
* functions, calls, operators, and structural forms
* pattern matching
* macros and meta concepts
* the relationship between specifications and implementations

Suggested reading order
-----------------------

If you are new to the family-level model, a practical order is:

1. :doc:`overview`
2. :doc:`mbf`
3. :doc:`functions-and-calls`
4. :doc:`operators`
5. :doc:`pattern-matching`
6. :doc:`macros-and-meta`
7. :doc:`implementations-and-specs`

When to read concepts first
---------------------------

Read this section before diving deeply into one implementation if you want to
understand the common Makrell model rather than learning one host track in
isolation.

If you prefer to learn from examples first, start with an implementation
quick-start or tutorial, then return here once the main forms look familiar.

How this section fits the rest of the site
------------------------------------------

The concept pages sit between the homepage/tutorial layer and the
implementation-specific pages. They are useful once you want a family-wide view
instead of only host-specific usage notes.

.. toctree::
   :maxdepth: 2

   overview
   mbf
   operators
   functions-and-calls
   pattern-matching
   macros-and-meta
   implementations-and-specs