General MX-Bluesky Developer Guide
==================================

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

.. grid:: 2
    :gutter: 2

    .. 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/get-started
            how-to/contribute
            how-to/build-docs
            how-to/run-tests
            how-to/static-analysis
            how-to/lint
            how-to/update-tools
            how-to/create-a-release
            how-to/deploy-a-release

        +++

        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

        +++

        Technical reference material on standards in use.