From: Junio C Hamano Date: Wed, 21 Oct 2026 16:22:03 GMT Subject: Re: [PATCH v2 2/2] MyFirstContribution: clarify that "reviewing" is a discussion Message-ID: In-Reply-To: Patrick Steinhardt writes: >> [[reviewing]] >> === Responding to Reviews >> >> -After a few days, you will hopefully receive a reply to your patchset with some >> -comments. Woohoo! Now you can get back to work. >> - >> -It's good manners to reply to each comment in the mailing list discussion >> -instead of letting the next version of your patch be your only response. Tell >> -the reviewer whether you plan to make the suggested change, keep the original, >> -or pursue a different approach. > > This is a sentence we lose in the rewrite, but I'd say that it may be > useful information to retain. Hmph, "communicate your plan" certainly is half lost. An early section ("now-what") advises to communicate "I'll do it differently, disregard this iteration" to avoid wasting reviewers' time, and the rewritten "reviewing" section somewhat hints to communicate other kind of plans with "your reasoning" in Do not start coding, much less send the next version of your patch, until you have finished discussing the current round of reviews with your reviewers. This saves time for both you and your reviewers. They can respond to your reasoning before you spend time preparing a version they might reject, and they will not have to inspect your 'v2' to check if you addressed their concerns. but it would be better to be more explicit how "your reasoning" should be presented, I guess. How about inserting "so that both sides know what to expect in the next round" to clarify what "finish discussing" entails? Do not start coding, let alone send the next version of your patch, until you have finished discussing the current one so both sides know what to expect. This saves time for everyone. Reviewers can respond to your explanation before you spend time preparing a patch they might reject, and they will not have to inspect 'v2' only to find their concerns unaddressed. Thanks.