===========
Explanation
===========

Explanation is the *understanding-oriented* part of the documentation.
It may contain information about design decisions, alternatives, context and related works.

You can look at the `original framework <https://diataxis.fr/explanation/>`_ to learn deeper what the explanation section is meant for.

.. toctree::
  :caption: Contents
  :maxdepth: 2

  explanation/generators
  explanation/derivation
  explanation/specifications