Contributing Guide
Where and How to get started
Find an issue in our repo to get started. You can also create a new issue or start a discussion item on GitHub.
Setup
To start working with the code, refer to our setup guide.
Ask questions in the #portal_dev channel of our Discord comunity.
Running Tests
Tests are run using pytest.
To run the tests:
make test
Test coverage
We aim for 100% test coverage. The coverage report is generated after running the tests, and can be viewed in the htmlcov
directory.
Code style and linting
Run make reformat
and make check
prior to committing your code.
There is a CI that checks for code style and linting issues.
PRs will not be merged if there is any CI failures.
Documentation Preview on Pull Requests
A documentation preview is generated for each pull request using Netlify. This allows us to preview the docs changes before merging the PR.