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

Explanation pages provide background, concepts, architecture, and context to
help you understand how Taurus works and why it behaves as it does.

Core concepts
-------------

.. toctree::
    :maxdepth: 2

    What is Taurus? <introduction>
    Models and schemes <models>

User interface concepts
-----------------------

.. toctree::
    :maxdepth: 2

    TaurusForm <forms>
    Plotting with Taurus <plotting>
    Trends and 2D trends <trends>
    Displaying images <images>
    Synoptics <synoptics>
    The TaurusGUI framework <taurusgui>
    Taurus colors <colors>

Extending and configuring Taurus
--------------------------------

.. toctree::
    :maxdepth: 2

    Extending Taurus widgets <custom_widgets>
    Tango event subscription modes <events>

Project design proposals
------------------------

Major Taurus design proposals and project-wide technical decisions are recorded
as `Taurus Enhancement Proposals (TEPs) <https://gitlab.com/taurus-org/taurus/-/blob/develop/doc/source/tep/index.md>`_.

For step-by-step instructions, see :doc:`How-to guides <../howto/index>`.
For exact APIs, settings, and extension points, see
:doc:`Reference <../reference/index>`.