We are happy to see your interest in conteributing to the project.
All development is tracked through GitHub issues in the repository.
If this is your first contribution, we encourage you to choose an issue with the good first issue
label.
If you want to work on something that is not yet reflected in an issue, please create one first to discuss the idea with the community. Add as many of the labels below as you see fit.
- bug
- dependencies
- documentation
- duplicate
- enhancement
- good first issue
- help wanted
- invalid
- question
- wontfix
To easily identify branches, we encourage you to use the following branch naming convention. Start with the category (outlined below), followed by the issue number (if available), and finally a descriptive name for the branch.
category/issue_number/branch_name
These are the categories.
Used for new features, that do not exist yet.
feature/123/user-login
Used for bugs that will be fixed in an upcoming release.
bugfix/1342/picture-not-displayed
Used for bugs that need to be fixed immediately and cannot wait until next release.
hotfix/1523/login-issue
Used for branches concerning solely the documentation of the project. Ideally documentation changes are carried out together with the implementation of what is documented, but in case that is not possible, use the docs category.
docs/add-contributing-guidelines
Branches with experimental features, that will most likely not be merged. Once a feature in and experimental branch has been validated, it can be moved to a feature branch.
exp/implement-flux-capacitor
Branches containing longer term work in progress, that has been started on but will not be finished anytime soon.
wip/add-camera-tests
After you have developed your contribution, it is time to create a pull request. Pull requests follow a similar naming scheme to branches, only with different formatting and the omission of the issue number (the pull request will be linked to the issue directly). In addition to the category, please include the area you worked on in the pull request title as well. The areas are separated into the different screens and components used. When working on a whole screen, the screen name as outlined below suffices, when your work is concentrated on a specific part of this screen, please use the part names as outlined below.
Example pull request titles:
[Feature] Controversies: Random Spotlight
[Bug] Scan: Merkel scanned as Amthor
- Profile
- Controversies
- Biography
- SideJobs
- Votes
- Overview
- Details
- Discover
- Scan
- Search
- ElectionChances
- FirstVote
- SecondVote