git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: [PATCH 4/6] MyFirstContribution: clarify that 'seen' does not mean acceptance

From
Junio C Hamano <gitster@pobox.com>
Date
Jul 12, 2026, 19:04 UTC
Message-ID
<xmqqqzl82fn8.fsf@gitster.g>
In-Reply-To
<DJWSKKVJM03B.1DTV8F9FXG9IF@lfurio.us>
"Matt Hunter" <m@lfurio.us> writes:
Show 10 quoted lines
> On Sat Jul 11, 2026 at 3:26 PM EDT, Junio C Hamano wrote:
>> +
>> +Plenty of early testers use `next` and
>>  may report issues. Eventually, changes in `next` will make it to `master`,
>>  which is typically considered stable. Finally, when a new release is cut,
>>  `maint` is used to base bugfixes onto. As mentioned at the beginning of this
>
> It feels odd not to reflow this paragraph, where the first line now just
> stops halfway across the width of the paragraph.  Though, the diff-churn
> may not be worth it in your eyes.

Yes, I did not want to force patch readers to review three extra lines just to spot a non-existent difference caused by an unnecessary reflow. Unlike SubmittingPatches, the target audience for MyFirstContribution is less familiar with our source files than experienced contributors are, so they will not be reading this in its source form anyway. Therefore, I thought leaving an unusually short line there was a reasonable trade-off until the entire paragraph needs to be rewritten.

However, when the next person who wants to modify this source file reads it, it will indeed be distracting to them. So, perhaps I should reflow the remainder of the paragraph.

Thanks.
Previous: Matt HunterNext: Junio C Hamano
Message 17 of 21 in “Update Contributor Guides”
  1. 0/6 Update Contributor GuidesJunio C Hamano, Jul 11, 2026
  2. 1/6 SubmittingPatches: clarify expected structure of commit log messageJunio C Hamano, Jul 11, 2026
  3. Weijie YuanJul 12, 2026
  4. Junio C HamanoJul 12, 2026
  5. Weijie YuanJul 13, 2026
  6. Michael MontalboJul 12, 2026
  7. Junio C HamanoJul 13, 2026
  8. Weijie YuanJul 13, 2026
  9. D. Ben KnobleJul 14, 2026
  10. Weijie YuanJul 17, 2026
  11. 2/6 MyFirstContribution: what if I don't get a reply?Junio C Hamano, Jul 11, 2026
  12. Patrick SteinhardtJul 17, 2026
  13. Junio C HamanoJul 17, 2026
  14. 3/6 MyFirstContribution: carrying over trailersJunio C Hamano, Jul 11, 2026
  15. 4/6 MyFirstContribution: clarify that 'seen' does not mean acceptanceJunio C Hamano, Jul 11, 2026
  16. Matt HunterJul 12, 2026
  17. Junio C HamanoJul 12, 2026
  18. 5/6 SubmittingPatches: clarify the meaning of "Will queue"Junio C Hamano, Jul 11, 2026
  19. 6/6 SubmittingPatches: clarify the writing style of whats-cookingJunio C Hamano, Jul 11, 2026
  20. Michael MontalboJul 12, 2026
  21. Junio C HamanoJul 13, 2026

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.