Difference between revisions of "Contribute"

From Bitmessage Wiki
Jump to navigation Jump to search
m (Added link to MS language portal)
m (more buildbot info)
 
(3 intermediate revisions by the same user not shown)
Line 1: Line 1:
==Code contributions to the Bitmessage project==
+
= 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. To find your repo's builds, navigate to "Builds" / "Last Changes" and at the top of your commit description, click on "See builds".
 +
 
 +
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 6: Line 23:
 
* try to follow [https://www.python.org/dev/peps/pep-0008/ PEP0008]
 
* try to follow [https://www.python.org/dev/peps/pep-0008/ PEP0008]
 
* 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
+
* 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]
  
If for some reason you don't want to use github, you can submit the patch using Bitmessage to the "bitmessage" chan, or to one of the developers.
+
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==

Latest revision as of 12:06, 25 December 2020

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.

  1. Login to GitHub
  2. If you haven't done so yet, fork the PyBitmessage repository
  3. Visit the PyBitmessage Buildbot installation page
  4. 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. To find your repo's builds, navigate to "Builds" / "Last Changes" and at the top of your commit description, click on "See builds".

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.