Re: [PATCH v4 0/3] Documentation: recommend the use of b4

[Toon Claes <toon@iotcl.com>]

Patrick Steinhardt <ps@pks.im> 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]: <xmqqik81xpqx.fsf@gitster.g>
>
> ---
> 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