CONTRIBUTING.md

How to contribute

Dependencies

We use poetry to manage the dependencies.

To install them you would need to run install command:

poetry install

To activate your virtualenv run poetry shell.

Style checks

We use pre-commit for quality control.

To run checks:

pre-commit run --hook-stage push --all-files

Submitting your code

We use trunk based development.

What the point of this method?

1. We use protected main branch, so the only way to push your code is via pull request
2. We use issue branches: to implement a new feature or to fix a bug create a new branch named issue-$TASKNUMBER
3. Then create a pull request to main branch
4. We use git tags to make releases, so we can track what has changed since the latest release

So, this way we achieve an easy and scalable development process which frees us from merging hell and long-living branches.

In this method, the latest version of the app is always in the main branch.

Before submitting

Before submitting your code please do the following steps:

1. Add any changes you want
2. Edit documentation if you have changed something significant
3. Update CHANGELOG.md with a quick summary of your changes
4. Run pre-commit run --hook-stage push --all-files to ensure that style and types are correct