Based on Material for MkDocs

https://squidfunk.github.io/mkdocs-material/getting-started/

Hatch is a tool for managing Python projects.

pip install hatch

Run the following command to get a server that will automatically update the docs pages whenever you edit the sources.

hatch run mkdocs serve

Run the following command to build the static site. The result will be in the site directory.

hatch run mkdocs build

This project uses mktestdocs to check the validity of python code samples. Code prefixed with python will be tested while code prefixed with py is not supposed to be a valid code (example: function signatures).

hatch run testing:test