Skip to content

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.