]> git.99rst.org Git - git.git/commit
SubmittingPatches: address design critiques
authorJunio C Hamano <redacted>
Sat, 20 Jun 2026 23:43:00 +0000 (16:43 -0700)
committerJunio C Hamano <redacted>
Sun, 21 Jun 2026 01:02:21 +0000 (18:02 -0700)
commit5fe19d285c832b12de1479c78231d53842b44583
treeefae4320cb33b32ab786aa9ebe1529ee9f5ea3b9
parent4621f8ce5e9b97aa2e8d0d9ffe9d25df2471074d
SubmittingPatches: address design critiques

Contributors sometimes fail to answer fundamental design or
viability comments from reviewers and submit subsequent rounds
without addressing them.  When design decisions are resolved on the
mailing list, the final justification should be recorded in the
commit messages.

Instruct authors to be particularly mindful of critiques regarding
high-level design or viability, to defend their choices on the list,
and to accompany new iterations with clearer explanations in the cover
letter, responses, and revised commit messages. Also instruct them to
explicitly document the resolution of these concerns in the commit
message body to keep the historical record complete.

Signed-off-by: Junio C Hamano <redacted>
Documentation/SubmittingPatches
git clone https://git.99rst.org/PROJECT