From e9356ad8fa475f9fea35c3605aaaef872582611f Mon Sep 17 00:00:00 2001 From: "patchback[bot]" <45432694+patchback[bot]@users.noreply.github.com> Date: Sun, 8 Aug 2021 11:48:35 +0200 Subject: [PATCH] contributing: make expected behavior clearer (#3168) (#3175) * contributing: make expected behavior clearer reformulate the preference of not having squashed commits clearer, shorter and more precise. https://github.com/ansible-collections/community.general/pull/3164#discussion_r684644504 * Update CONTRIBUTING.md Co-authored-by: Felix Fontein Co-authored-by: Felix Fontein (cherry picked from commit 85bcef3f5ac418d3244f144f3172e174ab3ba609) Co-authored-by: Sebastian --- CONTRIBUTING.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 285e14515c..586f7783ba 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -23,8 +23,7 @@ Note that reviewing does not only mean code review, but also offering comments o Also, consider taking up a valuable, reviewed, but abandoned pull request which you could politely ask the original authors to complete yourself. * Try committing your changes with an informative but short commit message. -* All commits of a pull request branch will be squashed into one commit at last. That does not mean you must have only one commit on your pull request, though! -* Please try not to force-push if it is not needed, so reviewers and other users looking at your pull request later can see the pull request commit history. +* Do not squash your commits and force-push to your branch if not needed. Reviews of your pull request are much easier with individual commits to comprehend the pull request history. All commits of your pull request branch will be squashed into one commit by GitHub upon merge. * Do not add merge commits to your PR. The bot will complain and you will have to rebase ([instructions for rebasing](https://docs.ansible.com/ansible/latest/dev_guide/developing_rebasing.html)) to remove them before your PR can be merged. To avoid that git automatically does merges during pulls, you can configure it to do rebases instead by running `git config pull.rebase true` inside the respository checkout. * Make sure your PR includes a [changelog fragment](https://docs.ansible.com/ansible/devel/community/development_process.html#changelogs-how-to). (You must not include a fragment for new modules or new plugins, except for test and filter plugins. Also you shouldn't include one for docs-only changes. If you're not sure, simply don't include one, we'll tell you whether one is needed or not :) )