Documentation Site

Developing And Testing

The documentation website is built using mkdocs and mkdocs-material.

To test:

bash

make serve-docs

Once running, you can view your locally built documentation at http://0.0.0.0:8000/. Making changes to documentation will automatically rebuild and refresh the view.

Before submitting a PR build the website, to verify that there are no errors building the site

bash

make build-docs

If you want to build and test the site directly on your local machine without the use of docker container, follow the below steps:

Install the dependencies from the root of this repository using the pip command
bash
```
pip install -r docs/requirements.txt
```
Build the docs site locally from the root
bash
```
make build-docs-local
```
Start the docs site locally
bash
```
make serve-docs-local
```

Analytics

[!TIP] Don't forget to disable your ad-blocker when testing.

We collect Google Analytics.