Warning

This version of the documentation is NOT an official release. You are looking at version ‘latest’, which is in active and ongoing development. You can change versions at the bottom left of the screen.

User documentation

We use Sphinx to generate the documentation and Read the Docs to publish it. Sphinx uses reStructuredText. To learn more about the syntax, check out this quick reference.

Requirements

Current working directory: nest-desktop/docs. To install Sphinx and the Read the Docs theme via pip:

python3 -m pip install sphinx sphinx_rtd_theme

Development: Render HTML offline

Build the documentation which your created with Sphinx in the docs folder offline:

rm -r _build/; make html

Publication: Push to ReadTheDocs

The documentation files for the main branch are automatically rebuilt (and updated) each time a push is made to the repository. The docs for other versions depend on the GitHub tags.