Developer Guide
===============

Documentation is split into four categories, also accessible from links in the
side-bar.

.. grid:: 2
    :gutter: 4

    .. grid-item-card:: :material-regular:`directions_run;3em`

        .. toctree::
            :caption: Tutorials
            :maxdepth: 1

            tutorials/dev-install

        +++

        Tutorials for getting up and running as a developer.

    .. grid-item-card:: :material-regular:`task;3em`

        .. toctree::
            :caption: How-to Guides
            :maxdepth: 1

            how-to/contribute
            how-to/build-docs
            how-to/run-tests
            how-to/static-analysis
            how-to/lint
            how-to/update-tools
            how-to/make-release
            how-to/pin-requirements
            how-to/test-container

        +++

        Practical step-by-step guides for day-to-day dev tasks.

    .. grid-item-card:: :material-regular:`apartment;3em`

        .. toctree::
            :caption: Explanations
            :maxdepth: 1

            explanations/decisions

        +++

        Explanations of how and why the architecture is why it is.

    .. grid-item-card:: :material-regular:`description;3em`

        .. toctree::
            :caption: Reference
            :maxdepth: 1

            reference/standards
            reference/contributing

        +++

        Technical reference material on standards in use.