From: Junio C Hamano <gitster@pobox.com>
To: git@vger.kernel.org
Subject: [PATCH 0/6] Update Contributor Guides
Date: Sat, 11 Jul 2026 12:26:44 -0700 [thread overview]
Message-ID: <20260711192650.2417665-1-gitster@pobox.com> (raw)
I have been tracking the rules I follow while updating the "What's
cooking" draft, which guides my daily work, and noticed a few gaps
in our contributor documentation.
* We often tell contributors how commit log messages should look on
the mailing list, but the language in `SubmittingPatches` is too
wordy. The first patch in this series shortens it to get to the
point earlier.
* We recently updated `MyFirstContribution` to advise contributors
to pace themselves when they find mistakes or receive feedback.
However, we lack instructions for when a patch receives no
reaction. The second patch addresses this gap.
* There seems to be some confusion regarding when contributors should
add `Reviewed-by:` and `Acked-by:` trailers. The third patch
clarifies this process.
* We want to ensure contributors don't walk away once their patch lands
in `seen`, as that is merely the beginning of the story. The fourth
and fifth patches clarify this point.
* An experimental feature in `SubmittingPatches` invites contributors
to draft the description for their topic in the "What's cooking"
report. However, instead of outlining the expected tone, we simply
told them to emulate existing entries. The final patch remedies this.
1/6: SubmittingPatches: clarify expected structure of commit log message
2/6: MyFirstContribution: what if I don't get a reply?
3/6: MyFirstContribution: carrying over trailers
4/6: MyFirstContribution: clarify that 'seen' does not mean acceptance
5/6: SubmittingPatches: clarify the meaning of "Will queue"
6/6: SubmittingPatches: clarify the writing style of whats-cooking
Documentation/MyFirstContribution.adoc | 53 +++++++-
Documentation/SubmittingPatches | 171 +++++++++++++------------
2 files changed, 135 insertions(+), 89 deletions(-)
--
2.55.0-391-gdf86bf5712
next reply other threads:[~2026-07-11 19:26 UTC|newest]
Thread overview: 17+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-07-11 19:26 Junio C Hamano [this message]
2026-07-11 19:26 ` [PATCH 1/6] SubmittingPatches: clarify expected structure of commit log message Junio C Hamano
2026-07-12 14:49 ` Weijie Yuan
2026-07-12 16:07 ` Junio C Hamano
2026-07-13 14:14 ` Weijie Yuan
2026-07-12 20:26 ` Michael Montalbo
2026-07-13 0:07 ` Junio C Hamano
2026-07-13 14:14 ` Weijie Yuan
2026-07-11 19:26 ` [PATCH 2/6] MyFirstContribution: what if I don't get a reply? Junio C Hamano
2026-07-11 19:26 ` [PATCH 3/6] MyFirstContribution: carrying over trailers Junio C Hamano
2026-07-11 19:26 ` [PATCH 4/6] MyFirstContribution: clarify that 'seen' does not mean acceptance Junio C Hamano
2026-07-12 18:08 ` Matt Hunter
2026-07-12 19:04 ` Junio C Hamano
2026-07-11 19:26 ` [PATCH 5/6] SubmittingPatches: clarify the meaning of "Will queue" Junio C Hamano
2026-07-11 19:26 ` [PATCH 6/6] SubmittingPatches: clarify the writing style of whats-cooking Junio C Hamano
2026-07-12 20:41 ` Michael Montalbo
2026-07-13 4:20 ` 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=20260711192650.2417665-1-gitster@pobox.com \
--to=gitster@pobox.com \
--cc=git@vger.kernel.org \
/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