Skip to content

Documentation

Documentation should be included alongside development so that the project is kept in sync.

The documentation is built using Material for MkDocs. This makes documentation easy to write, deploy, and manage as all docs are written in markdown files inside the docs directory. Deployment is handled automatically by GitHub Actions and GitHub pages.

Development

Writing docs should be simple.

In many cases, an existing page can simply be added to. If a new page needs to be created, then simply create a new markdown file and include its path in the nav section of /mkdocs.yml.

In order to serve a test site during development, ensure a virtual environment with the necessary plugins is loaded and execute the following command:

Terminal
mkdocs serve