Re: [PATCH] docs: submitting-patches: Advertise b4

From: Mauro Carvalho Chehab
Date: Tue Sep 03 2024 - 22:45:03 EST


Em Tue, 03 Sep 2024 23:42:04 +0100
Mark Brown <broonie@xxxxxxxxxx> escreveu:

> b4 is now widely used and is quite helpful for a lot of the things that
> submitting-patches covers, let's advertise it to submitters to try to make
> their lives easier and reduce the number of procedural issues maintainers
> see.
>
> Signed-off-by: Mark Brown <broonie@xxxxxxxxxx>
> ---
> Documentation/process/submitting-patches.rst | 10 ++++++++++
> 1 file changed, 10 insertions(+)
>
> diff --git a/Documentation/process/submitting-patches.rst b/Documentation/process/submitting-patches.rst
> index f310f2f36666..4b6904184ad1 100644
> --- a/Documentation/process/submitting-patches.rst
> +++ b/Documentation/process/submitting-patches.rst
> @@ -842,6 +842,16 @@ Make sure that base commit is in an official maintainer/mainline tree
> and not in some internal, accessible only to you tree - otherwise it
> would be worthless.
>
> +
> +Tooling
> +-------
> +
> +Many of the technical aspects of this process can be automated using
> +b4, documented at <https://b4.docs.kernel.org/en/latest/>. This can
> +help with things like tracking dependencies, running checkpatch and
> +with formatting and sending mails.
> +
> +

No need for two blank lines (yeah, there's a mix on this file of using
one or two blank lines for paragraphs).

I would also add quick example(s) on how to use it for common workflows.

> References
> ----------
>
>
> ---
> base-commit: 7c626ce4bae1ac14f60076d00eafe71af30450ba
> change-id: 20240903-documentation-b4-advert-18016e83d7d9
>
> Best regards,



Thanks,
Mauro