Difference between revisions of "Contributing to MPICH"
From Mpich
Line 1: | Line 1: | ||
+ | == Contributors' Agreement == | ||
For a person or company who wishes to submit a change to MPICH, you must first submit a signed contributors' agreement. http://www.mpich.org/documentation/contributor-docs/ | For a person or company who wishes to submit a change to MPICH, you must first submit a signed contributors' agreement. http://www.mpich.org/documentation/contributor-docs/ | ||
+ | == Submit a Pull Request == | ||
MPICH uses [https://git-scm.com/ git] to manage source code. The official repository is located at https://github.com/pmodels/mpich. Changes should be submitted in the form of a "pull request". More info on pull requests can be found here: https://help.github.com/categories/collaborating-with-issues-and-pull-requests/. Some of the more relevant sections for outside collaborators are: | MPICH uses [https://git-scm.com/ git] to manage source code. The official repository is located at https://github.com/pmodels/mpich. Changes should be submitted in the form of a "pull request". More info on pull requests can be found here: https://help.github.com/categories/collaborating-with-issues-and-pull-requests/. Some of the more relevant sections for outside collaborators are: | ||
* [https://help.github.com/articles/working-with-forks Working with forks] | * [https://help.github.com/articles/working-with-forks Working with forks] | ||
Line 6: | Line 8: | ||
** [https://help.github.com/articles/creating-a-pull-request-from-a-fork Creating a pull request from a fork] | ** [https://help.github.com/articles/creating-a-pull-request-from-a-fork Creating a pull request from a fork] | ||
− | + | === Tips for creating a patchset === | |
* Describe your changes, both in the pull request description and in each individual commit message. | * Describe your changes, both in the pull request description and in each individual commit message. | ||
** Describe the underlying issue, whether it be a bug or a new feature. | ** Describe the underlying issue, whether it be a bug or a new feature. |
Revision as of 15:59, 17 May 2017
Contributors' Agreement
For a person or company who wishes to submit a change to MPICH, you must first submit a signed contributors' agreement. http://www.mpich.org/documentation/contributor-docs/
Submit a Pull Request
MPICH uses git to manage source code. The official repository is located at https://github.com/pmodels/mpich. Changes should be submitted in the form of a "pull request". More info on pull requests can be found here: https://help.github.com/categories/collaborating-with-issues-and-pull-requests/. Some of the more relevant sections for outside collaborators are:
Tips for creating a patchset
- Describe your changes, both in the pull request description and in each individual commit message.
- Describe the underlying issue, whether it be a bug or a new feature.
- Describe the user-visible impact it will have.
- Separate your changes so that there is one logical change per patch.
- Each patch should stand on its own merits. If a patch depends on a previous one, it is helpful to note that in the commit message.
- Each patch in a series should be able to compile and run. This way bugs can be traced down using
git bisect
in the future. - How to Write a Git Commit Message