From: Taylor Blau <me@ttaylorr.com>
To: git@vger.kernel.org
Cc: Junio C Hamano <gitster@pobox.com>, Elijah Newren <newren@gmail.com>
Subject: [PATCH 0/2] SubmittingPatches: guidance for topic names and multi-series efforts
Date: Tue, 7 Oct 2025 17:39:34 -0400 [thread overview]
Message-ID: <cover.1759873165.git.me@ttaylorr.com> (raw)
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 reply other threads:[~2025-10-07 21:39 UTC|newest]
Thread overview: 10+ messages / expand[flat|nested] mbox.gz Atom feed top
2025-10-07 21:39 Taylor Blau [this message]
2025-10-07 21:39 ` [PATCH 1/2] SubmittingPatches: extend release-notes experiment to topic names Taylor Blau
2025-10-08 16:14 ` Kristoffer Haugsbakk
2025-10-08 20:51 ` Junio C Hamano
2025-10-08 21:24 ` Taylor Blau
2025-10-08 22:03 ` Kristoffer Haugsbakk
2025-10-08 21:20 ` Taylor Blau
2025-10-08 21:58 ` Kristoffer Haugsbakk
2025-10-07 21:39 ` [PATCH 2/2] SubmittingPatches: guidance for multi-series efforts Taylor Blau
2025-10-08 0:21 ` [PATCH 0/2] SubmittingPatches: guidance for topic names and " Junio C Hamano
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=cover.1759873165.git.me@ttaylorr.com \
--to=me@ttaylorr.com \
--cc=git@vger.kernel.org \
--cc=gitster@pobox.com \
--cc=newren@gmail.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).