Repository navigation
CONTRIBUTING.md: recommend shallow threading of cover letters - #6429
Merged
dscho merged 1 commit intoSep 26, 2026
Merged
Conversation
dscho
reviewed
Sep 22, 2026
| ``` | ||
| git send-email --to=git@vger.kernel.org --cc=<email1> --cc=<email2> \ | ||
| --in-reply-to=<the message id of cover letter of patch v2> [dir with patches]/*.patch | ||
| --in-reply-to=<the message id of cover letter of patch v1> [dir with patches]/*.patch |
The upstream Git project changed the guidance in 16b2924 (MyFirstContribution: recommend shallow threading of cover letters, 2026-06-15) to prefer arrangement where all cover letters are direct replies to the v1 cover letter. Update CONTRIBUTING.md to reflect that. Signed-off-by: Tuomas Ahola <taahol@utu.fi>
taahol
force-pushed
the
ta/contributing-md-shallow-threads
branch
from
September 24, 2026 10:19
1b58658 to
aef938a
Compare
Author
1: 1b586585f5e ! 1: aef938aebf5 fixup! CONTRIBUTING.md: add guide for first-time contributors
@@ Commit message
Update CONTRIBUTING.md to reflect that.
- While at it, replace (at times unresponsive) public-inbox.org
- links with links to lore.kernel.org.
-
Signed-off-by: Tuomas Ahola <taahol@utu.fi>
## CONTRIBUTING.md ##
-@@ CONTRIBUTING.md: you can fix quickly, or if anything catches your eye.
-
- You can also look at [the unofficial Chromium issues page](https://crbug.com/git) for
- multi-platform issues. You can look at recent user questions on
--[the Git mailing list](https://public-inbox.org/git).
-+[the Git mailing list](https://lore.kernel.org/git).
-
- Or you can "scratch your own itch", i.e. address an issue you have with Git. The team at Microsoft where the Git for Windows maintainer works, for example, is focused almost entirely on [improving performance](https://blogs.msdn.microsoft.com/devops/2018/01/11/microsofts-performance-contributions-to-git-in-2017/).
- We approach our work by finding something that is slow and try to speed it up. We start our
-@@ CONTRIBUTING.md: Submit Your Patch
-
- Git for Windows [accepts pull requests on GitHub](https://github.com/git-for-windows/git/pulls), but
- these are reserved for Windows-specific improvements. For core Git, submissions are accepted on
--[the Git mailing list](https://public-inbox.org/git).
-+[the Git mailing list](https://lore.kernel.org/git).
-
- ### Configure Git to Send Emails
-
@@ CONTRIBUTING.md: To construct a patch set, use the `git format-patch` command. There are three im
`git branch --edit-description`, you will end up with a 0/N mail with that description and
a nice overall diffstat.
* `--in-reply-to=[Message-ID]`: This will mark your cover letter as replying to the given
- message (which should correspond to your previous iteration). To determine the correct Message-ID,
-- find the message you are replying to on [public-inbox.org/git](https://public-inbox.org/git) and take
+ message (which should correspond to your first iteration). To determine the correct Message-ID,
-+ find the message you are replying to on [lore.kernel.org/git](https://lore.kernel.org/git) and take
+ find the message you are replying to on [public-inbox.org/git](https://public-inbox.org/git) and take
the ID from between the angle brackets.
- * `--subject-prefix=[prefix]`: This defaults to [PATCH]. For subsequent iterations, you will want to
@@ CONTRIBUTING.md: To submit a nth version patch (say version 3):
``` |
dscho
approved these changes
Sep 26, 2026
dscho
left a comment
dscho
left a comment
Member
There was a problem hiding this comment.
Thank you for taking my feedback, and for clarifying the change I didn't immediately understand.
This was referenced Sep 28, 2026
This was referenced Sep 28, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
No description provided.