Re: [PATCH v2 2/2] doc: advise batching patch rerolls
- From
- Weijie Yuan <wy@wyuan.org>
- Date
- Jun 25, 2026, 06:53 UTC
- Message-ID
- <ajzQdgkjGi4y3M0v@wyuan.org>
- In-Reply-To
- <ajvDrjk-bTvYaQtU@pks.im>
On Wed, Jun 24, 2026 at 01:46:54PM +0200, Patrick Steinhardt wrote:
Show 19 quoted lines
> > But here I think Patrick's original intention is: If your series is > > *close* to be accepted, (while I'm not sure what the precise definition > > of this "close to be accepted", does it means: commented by Junio with > > "Looks good", or reviewed by the community/core contributors with "Makes > > sense"?) and this time there happens to be a small issue, you can > > re-roll quickly to make your series more "sturdy" to wait for > > maintainer's final examination and further merges. > > > > So, I think the situation you are describing here is that this version > > of the patch has already been declared by the *author* to be the final > > version. (i.e. waiting for Junio to do the last exam) > > My "close to be accepted" feeling is when you've had multiple rounds of > design discussions already, everyone is on the same page, and all you > got on the last review round is a couple of typo fixes. > > But all of this is highly subjective, so it'll always depend and it > won't be easy to codify all of that. Nor is that necessary, I guess. We > really only want to provide some rough guidance.
Agreed, thanks!
Show 15 quoted lines
> > Therefore, I do not think the two situations conflict with each other, > > or are directly related. One concerns a patch that is already close to > > receiving the maintainer's final verdict, where a minor issue is > > discovered and the author quickly rerolls it. The other concerns an > > author who, without realizing that some issues remain unresolved, rushes > > to send what they believe to be the final version and then waits for the > > maintainer to review it. > > > > For the latter case, I think it would be better to add a sentence along > > the lines of: "Before sending a new version/the final version, check > > once more whether there are any unresolved issues," if the existing > > documentation does not already make this clear. > > I think that should mostly be clear with our documentation. And > eventually, we should also expect people to have some common sense :)
Agreed.
Show 9 quoted lines
> > That said, I am not familiar with how patch discussions have played out > > in the past, so please directly point out any mistakes in my > > understanding. I have to admit that, by this point in writing the > > message, I have become a little tangled up in my own reasoning. > > I guess that's kind of expected, mostly because many of these things are > highly subjective and will depend on the situation. The guidance does > not have to be perfect, you'll probably be able to find counterexamples > for many of the cases.
Yes, setting the rules too strictly may actually reduce flexibility of our project.
Thanks!