.. _sardana-how-to:

=============
How-to Guides
=============

This section contains task-oriented recipes for users who already know the
basics of Sardana. Each guide focuses on getting a specific job done:
configuring the system, writing macros and controllers, customizing scans
and data storage, managing the environment, and using the Spock and GUI
tools. For installation instructions see the :ref:`sardana-installing`
page.

If you are new to Sardana, start with the :ref:`sardana-tutorials` section.
Background information on concepts can be found in the
:ref:`sardana-explanation` section and complete API and configuration
references in the :ref:`sardana-reference` section.

.. toctree::
    :maxdepth: 2

    Configuration <configuration/index>
    Writing macros <macros/index>
    Writing controllers <controllers/index>
    Scans and data storage <scans/index>
    Environment variables <environment/index>
    Spock and GUI tools <tools/index>
    Development <development/index>