Documentation development

The documentation is generated, built and configured using a tool called Sphinx and is located in the docs/ directory of the repository. The actual files where this text is written are written using reStructuredText and are placed in the docs/source directory. A part of the documentation is autogenerate by the autodoc and autosummary sphinx extensions directly from the source code (this is why is important to add docstrings to the source code and correctly type hint the different functions). After each modify of the source you can apply the change compiling the documentation in one of the supported languages with:

sphinx-build -b html -D language='{LANG CODE}' source  build/{LANG CODE}

where {LANG CODE} has to be substituted with the ISO 639 code of the language.

To see the result you can open with your favourite browser the file docs/build/{LANG CODE}/index.html.