[patch 1/1] submitting-patches.rst: suggest a Link: after Reported-by:

[patch 1/1] submitting-patches.rst: suggest a Link: after Reported-by:

[Andrew Morton]

From: Andrew Morton <akpm@linux-foundation.org>
Subject: submitting-patches.rst: suggest a Link: after Reported-by:
Date: Thu Feb 23 05:41:49 PM PST 2023

It seems to be the new way and I find it super useful.

Cc: Joe Perches <joe@perches.com>
Cc: "Randy.Dunlap" <rdunlap@xenotime.net>
Cc: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
Cc: Jonathan Corbet <corbet@lwn.net>
Signed-off-by: Andrew Morton <akpm@linux-foundation.org>
---


--- a/Documentation/process/submitting-patches.rst~submitting-patchesrst-suggest-a-link-after-reported-by
+++ a/Documentation/process/submitting-patches.rst
@@ -501,6 +501,12 @@ the bug was reported in private, then as
 Reported-by tag. The tag is intended for bugs; please do not use it to credit
 feature requests.
 
+Where possible, please include a Link: to the report on the line
+immediately following the Reported-by:.  For example,
+
+Reported-by: John Doe <john.doe@gmail.com>
+  Link: https://lkml.kernel.org/r/02f796c7@gmail.com
+
 A Tested-by: tag indicates that the patch has been successfully tested (in
 some environment) by the person named.  This tag informs maintainers that
 some testing has been performed, provides a means to locate testers for
_

Re: [patch 1/1] submitting-patches.rst: suggest a Link: after Reported-by:

[Akira Yokosawa]

Hi Andrew,

On Thu, 23 Feb 2023 17:47:31 -0800, Andrew Morton wrote:
> It seems to be the new way and I find it super useful.
> 
> Cc: Joe Perches <joe@perches.com>
> Cc: "Randy.Dunlap" <rdunlap@xenotime.net>
> Cc: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
> Cc: Jonathan Corbet <corbet@lwn.net>
> Signed-off-by: Andrew Morton <akpm@linux-foundation.org>

JFYI, Jon has just applied a similar patch from Thorsten:

    https://lore.kernel.org/lkml/87ttzc40y9.fsf@meer.lwn.net/T/#t

    "Re: [PATCH v1] docs: recommend using Link: whenever using Reported-by:"

        Thanks, Akira

> ---
> 
> 
> --- a/Documentation/process/submitting-patches.rst~submitting-patchesrst-suggest-a-link-after-reported-by
> +++ a/Documentation/process/submitting-patches.rst
> @@ -501,6 +501,12 @@ the bug was reported in private, then as
>  Reported-by tag. The tag is intended for bugs; please do not use it to credit
>  feature requests.
>  
> +Where possible, please include a Link: to the report on the line
> +immediately following the Reported-by:.  For example,
> +
> +Reported-by: John Doe <john.doe@gmail.com>
> +  Link: https://lkml.kernel.org/r/02f796c7@gmail.com
> +
>  A Tested-by: tag indicates that the patch has been successfully tested (in
>  some environment) by the person named.  This tag informs maintainers that
>  some testing has been performed, provides a means to locate testers for
> _

Re: [patch 1/1] submitting-patches.rst: suggest a Link: after Reported-by:

[Andrew Morton]

On Fri, 24 Feb 2023 11:59:31 +0900 Akira Yokosawa <akiyks@gmail.com> wrote:

> Hi Andrew,
> 
> On Thu, 23 Feb 2023 17:47:31 -0800, Andrew Morton wrote:
> > It seems to be the new way and I find it super useful.
> > 
> > Cc: Joe Perches <joe@perches.com>
> > Cc: "Randy.Dunlap" <rdunlap@xenotime.net>
> > Cc: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
> > Cc: Jonathan Corbet <corbet@lwn.net>
> > Signed-off-by: Andrew Morton <akpm@linux-foundation.org>
> 
> JFYI, Jon has just applied a similar patch from Thorsten:
> 
>     https://lore.kernel.org/lkml/87ttzc40y9.fsf@meer.lwn.net/T/#t
> 
>     "Re: [PATCH v1] docs: recommend using Link: whenever using Reported-by:"
> 

Oh, OK, I preferred my version ;)

Whatever, I'll drop this.