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

[PATCH 0/2] SubmittingPatches: guidance for topic names and multi-series efforts

From
Taylor Blau <me@ttaylorr.com>
Date
Oct 7, 2025, 21:39 UTC
Message-ID
<cover.1759873165.git.me@ttaylorr.com>
A note to the maintainer, I suggest queueing this as:
 * tb/submitting-patches
   Extend the experimental protocol used by contributors to propose a
   topic branch name in addition to a description, and describe how to
   name multi-series efforts.
---

In [1], Junio suggested a few points to stress in our SubmittingPatches documentation, which are:

 - Mentioning what topics not in 'master' your patches depend on.
 - Suggesting one-line summaries for topics to be used as a topic
   branch name.
 - Describing your topic in the context of a multi-series effort.

The first is already covered by 0a02ca2383 (SubmittingPatches: simplify guidance for choosing a starting point, 2023-07-14), but the latter two are not.

The two patches part of this series address the latter two suggestions.

(As an aside, we should consider whether or not the experiment started in d255105c99 (SubmittingPatches: release-notes entry experiment, 2024-03-25) can yet be declared a success, and if so, graduate it.)

Thanks in advance for your review!
[1]: https://lore.kernel.org/git/xmqqcy7a5gnb.fsf@gitster.g/
Taylor Blau (2):
  SubmittingPatches: extend release-notes experiment to topic names
  SubmittingPatches: guidance for multi-series efforts
 Documentation/SubmittingPatches | 29 +++++++++++++++++++++--------
 1 file changed, 21 insertions(+), 8 deletions(-)
base-commit: 45547b60aca32b45d2f1ef93462cf9df28637c13
-- 
2.51.0.435.gf7a65e208c7
Next: Taylor Blau
Message 1 of 10 in “SubmittingPatches: guidance for topic names and multi-series efforts”
  1. 0/2 SubmittingPatches: guidance for topic names and multi-series effortsTaylor Blau, Oct 7, 2025
  2. 1/2 SubmittingPatches: extend release-notes experiment to topic namesTaylor Blau, Oct 7, 2025
  3. Kristoffer HaugsbakkOct 8, 2025
  4. Junio C HamanoOct 8, 2025
  5. Taylor BlauOct 8, 2025
  6. Kristoffer HaugsbakkOct 8, 2025
  7. Taylor BlauOct 8, 2025
  8. Kristoffer HaugsbakkOct 8, 2025
  9. 2/2 SubmittingPatches: guidance for multi-series effortsTaylor Blau, Oct 7, 2025
  10. Junio C HamanoOct 8, 2025

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.