Skip to content

Latest commit

 

History

History
46 lines (34 loc) · 877 Bytes

CONTRIBUTING.md

File metadata and controls

46 lines (34 loc) · 877 Bytes

Contributing

Contributions are welcome, and they are greatly appreciated! Every little bit helps, and credit will always be given.

Environment setup

You only need two tools, Poetry and Copier.

python3 -m pip install --user pipx
pipx install poetry
pipx install copier

Running tests

To run the tests, use:

make test

Serving docs

You can create a new virtualenv and install mkdocs and mkdocs-material:

python3 -m venv venv
. venv/bin/activate
pip install mkdocs mkdocs-material
mkdocs serve

You can also install mkdocs with pipx and inject mkdocs-material in its venv, this way you don't need to create one yourself:

python3 -m pip install --user pipx
pipx install mkdocs
pipx inject mkdocs mkdocs-material
mkdocs serve