.. _sardana-explanation:

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

This section contains conceptual material about how and why Sardana works:
its architecture, the model behind its elements and controllers, the motion,
acquisition and synchronization concepts, and the design rationale of the
MacroServer internals. The pages here are meant to be read for understanding,
not to be followed step by step — for task oriented documentation see the
:ref:`How-to guides <sardana-how-to>` and for technical descriptions see the
:ref:`Reference <sardana-reference>`.

.. toctree::
    :maxdepth: 2

    architecture
    pool
    elements
    controllers
    motion
    acquisition
    scans
    synchronization
    macroserver
    environment_backends
    performance