Modify CONTRIBUTING.md to prefer smaller commits over squashing them

See the updated text for the rationale.

Signed-off-by: Miloslav Trmač <mitr@redhat.com>
This commit is contained in:
Miloslav Trmač 2017-11-06 16:21:50 +01:00
parent 62c68998d7
commit 63b3be2f13

View File

@ -49,9 +49,9 @@ Regardless of the type of PR, all PRs should include:
* documentation changes * documentation changes
Squash your commits into logical pieces of work that might want to be reviewed Squash your commits into logical pieces of work that might want to be reviewed
separate from the rest of the PRs. But, squashing down to just one commit is ok separate from the rest of the PRs. Ideally, each commit should implement a single
too since in the end the entire PR will be reviewed anyway. When in doubt, idea, and the PR branch should pass the tests at every commit. GitHub makes it easy
squash. to review the cumulative effect of many commits; so, when in doubt, use smaller commits.
PRs that fix issues should include a reference like `Closes #XXXX` in the PRs that fix issues should include a reference like `Closes #XXXX` in the
commit message so that github will automatically close the referenced issue commit message so that github will automatically close the referenced issue