Difference between revisions of "Contribute"
PeterSurda (talk | contribs) |
PeterSurda (talk | contribs) (Add info about buildbot and gitea) |
||
Line 1: | Line 1: | ||
− | == | + | = How to contribute to the project = |
+ | |||
+ | Please follow the instructions below to find out how to best contribute to the project. | ||
+ | |||
+ | == Register with buildbot == | ||
+ | |||
+ | In order to contribute code, first please register your GitHub fork with the project's buildbot instance. This will then then execute all the code tests and builds that are currently available by just committing to your repository. | ||
+ | |||
+ | # Login to [https://github.com/ GitHub] | ||
+ | # If you haven't done so yet, fork the [https://github.com/Bitmessage/PyBitmessage PyBitmessage repository] | ||
+ | # Visit the [https://github.com/apps/pybitmessage-buildbot PyBitmessage Buildbot installation page] | ||
+ | # Install it into your account and give it access to your "PyBitmessage" repository | ||
+ | |||
+ | Now, whenever you push code, you can check [https://buildbot.bitmessage.org PyBitmessage Buildbot] for the results of the tests. | ||
+ | |||
+ | The tests are also run once you create a PR. | ||
+ | |||
+ | == Pull request requirements == | ||
The best code contributions are pull requests on [https://github.com/Bitmessage/PyBitmessage GitHub]. Here are some rules to follow: | The best code contributions are pull requests on [https://github.com/Bitmessage/PyBitmessage GitHub]. Here are some rules to follow: | ||
Line 7: | Line 24: | ||
* make the pull request against the [https://github.com/Bitmessage/PyBitmessage/tree/v0.6 "v0.6" branch] | * make the pull request against the [https://github.com/Bitmessage/PyBitmessage/tree/v0.6 "v0.6" branch] | ||
* it should be possible to do a fast-forward merge of the pull requests. I.e. if possible, do a rebase of a pull request after another is merged ahead of yours. However, if it can be merged without having to manually resolve a conflict, that's acceptable as well. | * it should be possible to do a fast-forward merge of the pull requests. I.e. if possible, do a rebase of a pull request after another is merged ahead of yours. However, if it can be merged without having to manually resolve a conflict, that's acceptable as well. | ||
− | * PGP-sign the commits included in the pull request | + | * PGP-sign the commits included in the pull request, and make sure to upload your PGP key into your GitHub account |
* You can get paid for merged commits if you register at [https://tip4commit.com/github/Bitmessage/PyBitmessage Tip4Commit] | * You can get paid for merged commits if you register at [https://tip4commit.com/github/Bitmessage/PyBitmessage Tip4Commit] | ||
− | If for some reason you don't want to use github, you can | + | If for some reason you don't want to use github, you can register with [https://git.bitmessage.org PyBitmessage Gitea], fork the latest archive of the project, and let us know which branch with the new code. |
==Translations== | ==Translations== |
Revision as of 16:10, 24 December 2020
Contents
How to contribute to the project
Please follow the instructions below to find out how to best contribute to the project.
Register with buildbot
In order to contribute code, first please register your GitHub fork with the project's buildbot instance. This will then then execute all the code tests and builds that are currently available by just committing to your repository.
- Login to GitHub
- If you haven't done so yet, fork the PyBitmessage repository
- Visit the PyBitmessage Buildbot installation page
- Install it into your account and give it access to your "PyBitmessage" repository
Now, whenever you push code, you can check PyBitmessage Buildbot for the results of the tests.
The tests are also run once you create a PR.
Pull request requirements
The best code contributions are pull requests on GitHub. Here are some rules to follow:
- try to explain what the code is about
- try to follow PEP0008
- make the pull request against the "v0.6" branch
- it should be possible to do a fast-forward merge of the pull requests. I.e. if possible, do a rebase of a pull request after another is merged ahead of yours. However, if it can be merged without having to manually resolve a conflict, that's acceptable as well.
- PGP-sign the commits included in the pull request, and make sure to upload your PGP key into your GitHub account
- You can get paid for merged commits if you register at Tip4Commit
If for some reason you don't want to use github, you can register with PyBitmessage Gitea, fork the latest archive of the project, and let us know which branch with the new code.
Translations
For helping with translations, please use Transifex. There is no need to submit pull requests for translations.
For translating technical terms it is recommended to consult the Microsoft Language Portal.