- Jinja2 is required by sphinx
- Version 3.1 and later are incompatible with the specified sphinx version
- see https://github.com/sphinx-doc/sphinx/issues/10291
- explicitly requiring this older version of Jinja2 solves this
- could be removed when moving to newer sphinx version
Convert the documentation to restructured text. It looks slightly
different to the previous Word document, but can better be handled by
source control. It also automatically handles the versioning.
To build it:
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
make html
make latexpdf