git.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
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

             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).