.. include:: ../README.rst :end-before: when included in index.rst .. |MyClass| image:: images/MyClass.png How the documentation is structured ----------------------------------- Documentation is split into four categories, accessible from links in the side-bar. .. rst-class:: columns Tutorials ~~~~~~~~~ Tutorials for installation, library and commandline usage. New users start here. .. toctree:: :caption: Tutorials :hidden: tutorials/installation .. rst-class:: columns How-to Guides ~~~~~~~~~~~~~ Practical step-by-step guides for the more experienced user. .. toctree:: :caption: How-to Guides :hidden: how-to/add-autodoc-directive .. rst-class:: columns Explanations ~~~~~~~~~~~~ Explanation of how the library works and why it works that way. .. toctree:: :caption: Explanations :hidden: explanations/how-it-works .. rst-class:: columns Reference ~~~~~~~~~ Technical reference material, for classes, methods, APIs, commands, and contributing to the project. .. toctree:: :caption: Reference :hidden: reference/contributing .. rst-class:: endcolumns About the documentation ~~~~~~~~~~~~~~~~~~~~~~~ `Why is the documentation structured this way? `_