User 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_walk;3em`

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

            tutorials/00-prereq
            tutorials/01-setup
            tutorials/02-orientation
            tutorials/03-variables
            tutorials/04-loops
            tutorials/05-functions
            tutorials/05a-modules
            tutorials/06-if-then
            tutorials/07-lists
            tutorials/08-classes
            tutorials/09-dictionaries
            tutorials/10-threading
            tutorials/11-switches
            tutorials/12-signs
            tutorials/13-structures

        +++

        Tutorials for installation and typical usage. New users start here.

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

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

            how-to/startup
            how-to/completion
            how-to/extensions
            how-to/troubleshooting
            how-to/backup
            how-to/wsl2
            how-to/coordinates
            how-to/run-container

        +++

        Practical step-by-step guides for the more experienced user.

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

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

            explanations/docs-structure
            explanations/scope
            explanations/server-config
            explanations/coordinates
            explanations/mcipc
            explanations/mcee


        +++

        Explanations of how the library works and why it works that way.

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

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

            reference/index
            reference/api
            reference/demo
            ../genindex

        +++

        Technical reference material including APIs and release notes.