How-to guides
=============

How-to guides are task-oriented instructions for solving specific problems
with Taurus. They assume some familiarity with Taurus and focus on getting a
particular job done.

User interface
--------------

Work with the main Taurus widgets, visualization tools, and GUI applications.

.. toctree::
    :maxdepth: 2

    Use Taurus forms <forms>
    Create a basic SVG synoptic <svg_synoptics>
    Organize models in a TaurusGrid <taurus_grid>
    Select models with TaurusModelChooser <model_chooser>
    Edit arrays <array_editor>
    Use device panels <device_panels>
    Work with TaurusPlot <plotting>
    Work with Taurus trends <trends>
    Display an image attribute <images>
    Work with TaurusGUI applications <taurusgui>
    Troubleshoot Taurus widgets in Qt Designer <designer>
    Browse Taurus configurations <configurations>
    Monitor Taurus logs <logs>
    Inspect a running Taurus GUI <diagnostics>
    Create custom Taurus widgets <custom_widgets>

Models and data
---------------

Work with Taurus models and derived values.

.. toctree::
    :maxdepth: 2

    Work with evaluated models <evaluated_models>
    Create a custom Taurus scheme <custom_scheme>

Configuration
-------------

Configure runtime behavior and user-level Taurus settings.

.. toctree::
    :maxdepth: 2

    Change the Tango event subscription mode <event_subscription_mode>

Development
-----------

Contribute to Taurus and work with its development conventions and tools.

.. toctree::
    :maxdepth: 2

    Development guides <development/index>

Migration
---------

Guides for adapting code when moving between Taurus versions.

.. toctree::
    :maxdepth: 2

    Migration guides <migration/index>

If you need background on why Taurus behaves in a certain way, see
:doc:`Explanation <../explanation/index>`. For exact API and configuration
information, see :doc:`Reference <../reference/index>`.