Thread (3 messages) 3 messages, 3 authors, 2025-10-08

Re: [PATCH 1/2] SubmittingPatches: extend release-notes experiment to topic names

From: Junio C Hamano <hidden>
Date: 2025-10-08 20:51:26

"Kristoffer Haugsbakk" [off-list ref] writes:
I like the format in the cover letter:

     * 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.
Hmph, but the paragraphs that eventually go into RelNotes are not
commit log messages.  "Extend the protocol A to achieve X" is what
we would write in our proposed log messages, but after such a patch
achieves X by extending the protocol A, we'd report it in our
release notes by saying something ike "The protocol A was extended
in such and such way to achieve X".
But it was noted[1] that the-topic-summary doesn’t seem to have been
used much. That’s not surprising given that the instruction makes
the-topic-summary blend in with the rest of the cover letter and doesn’t
signal that the author intends for the first paragraph to be used as
such. This patch shares the same problem.
Oh, that's a new theory.  So you are saying that authors may have
tried but I (and others) failed to notice?  It cetainly is possible.
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help