- Fork the repository.
- Using Markdown syntax, edit or create new files for the documentation in the
/mkdocs
directory. - Use headings, bullet points or numbered lists, code blocks and other formatting tools to make the documentation easy to read and understand.
- Use clear and concise language to explain the features, functions or concepts that are being documented.
- Use hyperlinks, images or other visual aids to enhance the documentation.
- Use the appropriate
/assets
folder for your static assets. Eg. Images goes under/assets/img
- Add a new item or adjust menu levels through the
mkdocs.yml
file if you have made any structural modifications. - When finished, commit and push your changes to your forked repository.
- Open a pull request and ask for feedback from the community.
- Keep your contributions up-to-date with any changes or updates made to the main repository.
There is a dedicated channel for Docs on our official Discord, don't be shy and contact us there if you need help!
To modify the behavior of MkDocs and its plugins, everything you need is within the mkdocs.yml
file.
We invite you to read the documentation for the MkDocs Material theme to fully understand all the potential of the tool and how to make the most of its extensive features.
- Python 3.8+
- Pip 20+
Install dependencies:
$ pip install -r requirements.txt
$ mkdocs serve
or $ python -m mkdocs serve
will launch a local, non static, instance of the documentation website.
The build stage is automated using GitHub action, you don't need to do it in order to contribute. However, if you want to have a static copy of the documentation on your local machine you are free to do it.
$ mkdocs build
or $ python -m mkdocs build
will create the actual docs static website in a folder named /docs
.