From: Toon Claes Date: Tue, 16 Jun 2026 06:40:14 GMT Subject: Re: [PATCH v4 0/3] Documentation: recommend the use of b4 Message-ID: <87eci7yomp.fsf@emacs.iotcl.com> In-Reply-To: <20260615-pks-b4-v4-0-22cfca8f19c5@pks.im> Patrick Steinhardt writes: > Hi, > > this small patch series wires up b4 in Git and recommends the use > thereof via "MyFirstContribution", as discussed in [1]. > > Changes in v4: > - Improve a commit message. > - Link to v3: https://patch.msgid.link/20260608-pks-b4-v3-0-f5e497d10c56@pks.im > > Changes in v3: > - I wasn't really able to judge consensus one way or the other > regarding the deep vs shallow nesting of cover letters, so I still > have the change to shallow nesting of cover letters part of this > series. If we continue to be split on this one (or if we favor the > current status quo) I'm happy to drop the first patch and adapt the > last patch to use deep nesting of cover letters instead. > - Hopefully fix some confusion by saying "shallow/deep threading of > cover letters". > - Fix some more instances where we recommend deep threading of cover > letters. > - Link to v2: https://patch.msgid.link/20260603-pks-b4-v2-0-a8aea0aa2c23@pks.im > > Changes in v2: > - Reorder commits so that the b4 docs are added first. > - Add a section that highlights how to configure b4, and that points > out that the per-project defaults can be overridden via Git > configuration. > - Add a patch to MyFirstContribution that recommends shallow > threading. I mostly intend this to be a discussion starter so that > the `.b4-config` file matches our preferred threading style. > - Fix a typo. > - Link to v1: https://patch.msgid.link/20260602-pks-b4-v1-0-a7ae5a49e9cf@pks.im > > Thanks! > > Patrick > > [1]: > > --- > Patrick Steinhardt (3): > MyFirstContribution: recommend shallow threading of cover letters > MyFirstContribution: recommend the use of b4 > b4: introduce configuration for the Git project > > .b4-config | 6 ++ > .b4-cover-template | 11 ++++ > Documentation/MyFirstContribution.adoc | 100 ++++++++++++++++++++++++++++++--- > Documentation/SubmittingPatches | 6 +- > 4 files changed, 114 insertions(+), 9 deletions(-) > > Range-diff versus v3: > > 1: 1aec56f76c = 1: b6b488e6a8 MyFirstContribution: recommend shallow threading of cover letters > 2: f2036769bd = 2: 1a68b993d2 MyFirstContribution: recommend the use of b4 > 3: fb522c7d90 ! 3: 5bc8fba96a b4: introduce configuration for the Git project > @@ Metadata > ## Commit message ## > b4: introduce configuration for the Git project > > - We're about to extend our documentation to recommend b4 for sending > - patch series to the mailing list. Prepare for this by introducing a b4 > - configuration so that the tool knows to honor our preferences. For now, > - this configuration does two things: > + In the preceding commit we have extended our documentation to recommend > + b4 for sending patch series to the mailing list. Introduce configuration > + so that it knows to honor preferences of the Git project by default. For > + now, this configuration does two things: > > - It configures "send-same-thread = shallow", which tells b4 to always > send subsequent versions of the same patch series as a reply to the No further comments based on the range-diff. -- Cheers, Toon