Using Git and GitHub to Contribute
- Open an issue, take over one you are assigned to, or assign yourself to one that hasn't been processed yet.
- Create a branch named
issue-<issue_numer>
, where<issue_numer>
is the identifier of the issue. - Fix a bug or implement a new feature. In the second scenario, implement new unit tests for validating the changes. These can be locally run with
MUTABLESECURITY_TESTS_PASS=<password> poe covtest
, where<password>
is the password of the local system. The coverage needs to remain above 90% and should decrease with maximum 1% comparative to the last commit. - Check if the files are formatted correctly with
poe lint
. - Commit the changed files by respecting the commit format.
- Create a pull request from your branch to
main
by respecting the corresponding format. - Ask another contributor to review and test the changes.
- If the unit tests pass and the other contributor approved the changes, then merge the pull request by rebase.
- Delete the old branch.