git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: [PATCH v2 2/2] doc: advise batching patch rerolls

From
WYWeijie 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!
Previous: Patrick SteinhardtNext: Weijie Yuan
Message 16 of 22 in “doc: clarify review replies and reroll timing”
  1. 0/2 doc: clarify review replies and reroll timingWeijie Yuan, Jun 13, 2026
  2. 1/2 doc: encourage review replies before rerollingWeijie Yuan, Jun 13, 2026
  3. Patrick SteinhardtJun 15, 2026
  4. Weijie YuanJun 15, 2026
  5. 2/2 doc: advise batching patch rerollsWeijie Yuan, Jun 13, 2026
  6. Junio C HamanoJun 13, 2026
  7. Weijie YuanJun 13, 2026
  8. Patrick SteinhardtJun 15, 2026
  9. Weijie YuanJun 15, 2026
  10. 0/2 doc: clarify review replies and reroll timingWeijie Yuan, Jun 17, 2026
  11. 1/2 doc: encourage review replies before rerollingWeijie Yuan, Jun 17, 2026
  12. 2/2 doc: advise batching patch rerollsWeijie Yuan, Jun 17, 2026
  13. Junio C HamanoJun 17, 2026
  14. Weijie YuanJun 19, 2026
  15. Patrick SteinhardtJun 24, 2026
  16. Weijie YuanJun 25, 2026
  17. 0/2 doc: clarify review replies and reroll timingWeijie Yuan, Jun 21, 2026
  18. 1/2 doc: encourage review replies before rerollingWeijie Yuan, Jun 21, 2026
  19. 2/2 doc: advise batching patch rerollsWeijie Yuan, Jun 21, 2026
  20. Patrick SteinhardtJun 24, 2026
  21. Patrick SteinhardtJun 24, 2026
  22. Weijie YuanJun 25, 2026

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.