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

Re: [RFC PATCH] MyFirstContribution: mention trimming quoted text in replies

From
Junio C Hamano <gitster@pobox.com>
Date
Jun 11, 2026, 23:48 UTC
Message-ID
<xmqqcxxwljue.fsf@gitster.g>
In-Reply-To
<080402ff0ac8127b654dccea59a1bf643df62a5c.1781186476.git.wy@wyuan.org>
Weijie Yuan <wy@wyuan.org> writes:
Show 6 quoted lines
> ReviewingGuidelines already advises reviewers to trim irrelevant quoted
> context when replying. Give the same advice to new contributors in
> MyFirstContribution, so our documentation is consistent about mailing
> list reply etiquette.
>
> Signed-off-by: Weijie Yuan <wy@wyuan.org>
Makes sense.
Show 16 quoted lines
> diff --git a/Documentation/MyFirstContribution.adoc b/Documentation/MyFirstContribution.adoc
> index 607876f3d8..0e2a9313ce 100644
> --- a/Documentation/MyFirstContribution.adoc
> +++ b/Documentation/MyFirstContribution.adoc
> @@ -1453,6 +1453,11 @@ effect which had not occurred to you. It is always okay to ask for clarification
>  if you aren't sure why a change was suggested, or what the reviewer is asking
>  you to do.
>  
> +When replying to review comments, quote only the parts of the message that are
> +relevant to your response. It is usually helpful to trim away unrelated context,
> +such as large portions of the patch that are not being discussed, while keeping
> +enough quoted text for readers to understand what you are responding to.
> +
>  Make sure your email client has a plaintext email mode and it is turned on; the
>  Git list rejects HTML email. Please also follow the mailing list etiquette
>  outlined in the

The insertion point is well chosen, immediately following the discussion on how to handle review comments and before the technical details of email client configuration. The text itself is clear and gives sound advice.

Will queue and wait for others to weigh in.  Thanks.
Previous: Weijie YuanNext: Weijie Yuan
Message 2 of 3 in “MyFirstContribution: mention trimming quoted text in replies”
  1. MyFirstContribution: mention trimming quoted text in repliesWeijie Yuan, Jun 11, 2026
  2. Junio C HamanoJun 11, 2026
  3. Weijie YuanJun 12, 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.