Project uses Sphinx to generate documentation from docstrings (documentation in-code) and custom pages written in Markdown (through the MyST parser).

Build documentation website#

To build it:

# install additional dependencies
python -m pip install -U -r requirements/documentation.txt
# build it
sphinx-build -b html docs docs/_build/html

Open docs/_build/index.html in a web browser.

Write documentation using live render#

sphinx-autobuild -b html docs/ docs/_build/html

Open http://localhost:8000 in a web browser to see the HTML render updated when a file is saved.