Make git-contacts more prominent in our docs. Notable changes in v2 ===================== * Improve existing mention of git-contacts in SubmittingPatches (instead of adding a separate, entirely new paragraph) * Add example usage of integrating git-contacts with git-send-email with the latter's --cc-cmd flag. * Various smaller fixes to SubmittingPatches Linus Arver (8): MyFirstContribution: mention contrib/contacts/git-contacts SubmittingPatches: make 'git contacts' grep-friendly SubmittingPatches: mention GitGitGadget SubmittingPatches: quote commands SubmittingPatches: discuss reviewers first SubmittingPatches: dedupe discussion of security patches SubmittingPatches: add heading for format-patch and send-email SubmittingPatches: demonstrate using git-contacts with git-send-email Documentation/MyFirstContribution.txt | 5 ++ Documentation/SubmittingPatches | 68 +++++++++++++++------------ 2 files changed, 43 insertions(+), 30 deletions(-) base-commit: c2cbfbd2e28cbe27c194d62183b42f27a6a5bb87 Published-As: https://github.com/gitgitgadget/git/releases/tag/pr-1704%2Flistx%2Freviewers-v2 Fetch-It-Via: git fetch https://github.com/gitgitgadget/git pr-1704/listx/reviewers-v2 Pull-Request: https://github.com/gitgitgadget/git/pull/1704 Range-diff vs v1: 1: 7f1ac742008 ! 1: 3817e7f3cd0 docs: recommend using contrib/contacts/git-contacts @@ Metadata Author: Linus Arver <linusa@xxxxxxxxxx> ## Commit message ## - docs: recommend using contrib/contacts/git-contacts + MyFirstContribution: mention contrib/contacts/git-contacts Although we've had this script since 4d06402b1b (contrib: add git-contacts helper, 2013-07-21), we don't mention it in our @@ Documentation/MyFirstContribution.txt: $ git send-email --to=target@xxxxxxxxxxx valuable, such as changing the Reply-to address or adding more CC and BCC lines. +NOTE: Use `contrib/contacts/git-contacts` to get a list of reviewers you should -+include in the CC list. ++include in the CC list. In addition, you can do `git send-email --cc-cmd='git ++contacts' feature/*.patch` to automatically pass this list of emails to ++`send-email`. + NOTE: When you are sending a real patch, it will go to git@xxxxxxxxxxxxxxx - but please don't send your patchset from the tutorial to the real mailing list! For now, you can send it to yourself, to make sure you understand how it will look. - - ## Documentation/SubmittingPatches ## -@@ Documentation/SubmittingPatches: an explanation of changes between each iteration can be kept in - Git-notes and inserted automatically following the three-dash - line via `git format-patch --notes`. - -+[[suggested-reviewers]] -+Use `contrib/contacts/git-contacts` to get a list of reviewers you should -+include in the CC list. -+ - [[attachment]] - Do not attach the patch as a MIME attachment, compressed or not. - Do not let your e-mail client send quoted-printable. Do not let -: ----------- > 2: 82e5e05288d SubmittingPatches: make 'git contacts' grep-friendly -: ----------- > 3: 6e6950afa6e SubmittingPatches: mention GitGitGadget -: ----------- > 4: fb06d5ce247 SubmittingPatches: quote commands -: ----------- > 5: a8abcf45881 SubmittingPatches: discuss reviewers first -: ----------- > 6: 326afe13315 SubmittingPatches: dedupe discussion of security patches -: ----------- > 7: 09f4e7ad123 SubmittingPatches: add heading for format-patch and send-email -: ----------- > 8: b35748f0cf8 SubmittingPatches: demonstrate using git-contacts with git-send-email -- gitgitgadget
