[PATCH] docs: link AI coding assistants and tool-generated content pages

[PATCH] docs: link AI coding assistants and tool-generated content pages

[Lorenzo Stoakes]

Both of these guidelines are complimentary to one another - one specifying
guidelines on AI coding assistants, and the other specifying those for
tool-generated content.

Since they are complimentary to one another, provide a link to each in the
other.

Signed-off-by: Lorenzo Stoakes <ljs@kernel.org>
---
 Documentation/process/coding-assistants.rst | 4 ++++
 Documentation/process/generated-content.rst | 7 +++++++
 2 files changed, 11 insertions(+)

diff --git a/Documentation/process/coding-assistants.rst b/Documentation/process/coding-assistants.rst
index 899f4459c52d..6125ee4914c5 100644
--- a/Documentation/process/coding-assistants.rst
+++ b/Documentation/process/coding-assistants.rst
@@ -15,6 +15,10 @@ kernel development process:
 * Documentation/process/coding-style.rst
 * Documentation/process/submitting-patches.rst

+For guidelines on content generated by AI coding assistants see:
+
+* Documentation/process/generated-content.rst
+
 Licensing and Legal Requirements
 ================================

diff --git a/Documentation/process/generated-content.rst b/Documentation/process/generated-content.rst
index 08621e50a462..aad2caad9f8b 100644
--- a/Documentation/process/generated-content.rst
+++ b/Documentation/process/generated-content.rst
@@ -107,3 +107,10 @@ the resulting changes.

 If you do so anyway, maintainers are entitled to reject your series
 without detailed review.
+
+References
+==========
+
+For specific guidelines on AI coding assistants, see:
+
+* Documentation/process/coding-assistants.rst
--
2.55.0

Re: [PATCH] docs: link AI coding assistants and tool-generated content pages

[Jeff Layton]

On Thu, 2026-07-02 at 17:49 +0100, Lorenzo Stoakes wrote:
> Both of these guidelines are complimentary to one another - one specifying
> guidelines on AI coding assistants, and the other specifying those for
> tool-generated content.
> 
> Since they are complimentary to one another, provide a link to each in the
> other.
> 
> Signed-off-by: Lorenzo Stoakes <ljs@kernel.org>
> ---
>  Documentation/process/coding-assistants.rst | 4 ++++
>  Documentation/process/generated-content.rst | 7 +++++++
>  2 files changed, 11 insertions(+)
> 
> diff --git a/Documentation/process/coding-assistants.rst b/Documentation/process/coding-assistants.rst
> index 899f4459c52d..6125ee4914c5 100644
> --- a/Documentation/process/coding-assistants.rst
> +++ b/Documentation/process/coding-assistants.rst
> @@ -15,6 +15,10 @@ kernel development process:
>  * Documentation/process/coding-style.rst
>  * Documentation/process/submitting-patches.rst
> 
> +For guidelines on content generated by AI coding assistants see:
> +
> +* Documentation/process/generated-content.rst
> +
>  Licensing and Legal Requirements
>  ================================
> 
> diff --git a/Documentation/process/generated-content.rst b/Documentation/process/generated-content.rst
> index 08621e50a462..aad2caad9f8b 100644
> --- a/Documentation/process/generated-content.rst
> +++ b/Documentation/process/generated-content.rst
> @@ -107,3 +107,10 @@ the resulting changes.
> 
>  If you do so anyway, maintainers are entitled to reject your series
>  without detailed review.
> +
> +References
> +==========
> +
> +For specific guidelines on AI coding assistants, see:
> +
> +* Documentation/process/coding-assistants.rst
> --
> 2.55.0

Reviewed-by: Jeff Layton <jlayton@kernel.org>

Re: [PATCH] docs: link AI coding assistants and tool-generated content pages

[David Hildenbrand (Arm)]

On 7/2/26 18:49, Lorenzo Stoakes wrote:
> Both of these guidelines are complimentary to one another - one specifying
> guidelines on AI coding assistants, and the other specifying those for
> tool-generated content.
> 
> Since they are complimentary to one another, provide a link to each in the
> other.
> 
> Signed-off-by: Lorenzo Stoakes <ljs@kernel.org>
> ---

As long as these documents exist, that makes sense :)

Reviewed-by: David Hildenbrand (Arm) <david@kernel.org>

-- 
Cheers,

David

Re: [PATCH] docs: link AI coding assistants and tool-generated content pages

[Laurent Pinchart]

On Thu, Jul 02, 2026 at 05:49:01PM +0100, Lorenzo Stoakes wrote:
> Both of these guidelines are complimentary to one another - one specifying
> guidelines on AI coding assistants, and the other specifying those for
> tool-generated content.
> 
> Since they are complimentary to one another, provide a link to each in the
> other.
> 
> Signed-off-by: Lorenzo Stoakes <ljs@kernel.org>
> ---
>  Documentation/process/coding-assistants.rst | 4 ++++
>  Documentation/process/generated-content.rst | 7 +++++++
>  2 files changed, 11 insertions(+)
> 
> diff --git a/Documentation/process/coding-assistants.rst b/Documentation/process/coding-assistants.rst
> index 899f4459c52d..6125ee4914c5 100644
> --- a/Documentation/process/coding-assistants.rst
> +++ b/Documentation/process/coding-assistants.rst
> @@ -15,6 +15,10 @@ kernel development process:
>  * Documentation/process/coding-style.rst
>  * Documentation/process/submitting-patches.rst
> 
> +For guidelines on content generated by AI coding assistants see:
> +
> +* Documentation/process/generated-content.rst
> +

It could be worth it checking if this increases the likelyhood that an
agent would include a disclosure statement in patches. I would have
assumed that the "Attribution" section in this file to be enough. Has
anyone ever tried to understand why it doesn't work and if it can be
improved ?

Maybe a stronger statement would help here:

"Furthermore, AI tools must follow the guidelines for generated content
documented in Documentation/process/generated-content.rst."

>  Licensing and Legal Requirements
>  ================================
> 
> diff --git a/Documentation/process/generated-content.rst b/Documentation/process/generated-content.rst
> index 08621e50a462..aad2caad9f8b 100644
> --- a/Documentation/process/generated-content.rst
> +++ b/Documentation/process/generated-content.rst
> @@ -107,3 +107,10 @@ the resulting changes.
> 
>  If you do so anyway, maintainers are entitled to reject your series
>  without detailed review.
> +
> +References
> +==========
> +
> +For specific guidelines on AI coding assistants, see:
> +
> +* Documentation/process/coding-assistants.rst

-- 
Regards,

Laurent Pinchart

Re: [PATCH] docs: link AI coding assistants and tool-generated content pages

[SJ Park]

On Thu,  2 Jul 2026 17:49:01 +0100 Lorenzo Stoakes <ljs@kernel.org> wrote:

> Both of these guidelines are complimentary to one another - one specifying
> guidelines on AI coding assistants, and the other specifying those for
> tool-generated content.
> 
> Since they are complimentary to one another, provide a link to each in the
> other.

Makes perfect sense to me.

> 
> Signed-off-by: Lorenzo Stoakes <ljs@kernel.org>

Acked-by: SJ Park <sj@kernel.org>

> ---
>  Documentation/process/coding-assistants.rst | 4 ++++
>  Documentation/process/generated-content.rst | 7 +++++++
>  2 files changed, 11 insertions(+)
> 
> diff --git a/Documentation/process/coding-assistants.rst b/Documentation/process/coding-assistants.rst
> index 899f4459c52d..6125ee4914c5 100644
> --- a/Documentation/process/coding-assistants.rst
> +++ b/Documentation/process/coding-assistants.rst
> @@ -15,6 +15,10 @@ kernel development process:
>  * Documentation/process/coding-style.rst
>  * Documentation/process/submitting-patches.rst
> 
> +For guidelines on content generated by AI coding assistants see:

A comma after 'assistants' is missed?

> +
> +* Documentation/process/generated-content.rst
> +
>  Licensing and Legal Requirements
>  ================================
> 
> diff --git a/Documentation/process/generated-content.rst b/Documentation/process/generated-content.rst
> index 08621e50a462..aad2caad9f8b 100644
> --- a/Documentation/process/generated-content.rst
> +++ b/Documentation/process/generated-content.rst
> @@ -107,3 +107,10 @@ the resulting changes.
> 
>  If you do so anyway, maintainers are entitled to reject your series
>  without detailed review.
> +
> +References
> +==========
> +
> +For specific guidelines on AI coding assistants, see:

Or, a comma is unnecessarily added after 'assistants'.

Whatever, I think keeping those identical is better.


Thanks,
SJ

[...]

Re: [PATCH] docs: link AI coding assistants and tool-generated content pages

[Greg KH]

On Thu, Jul 02, 2026 at 05:49:01PM +0100, Lorenzo Stoakes wrote:
> Both of these guidelines are complimentary to one another - one specifying
> guidelines on AI coding assistants, and the other specifying those for
> tool-generated content.
> 
> Since they are complimentary to one another, provide a link to each in the
> other.
> 
> Signed-off-by: Lorenzo Stoakes <ljs@kernel.org>
> ---
>  Documentation/process/coding-assistants.rst | 4 ++++
>  Documentation/process/generated-content.rst | 7 +++++++
>  2 files changed, 11 insertions(+)
> 

Reviewed-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>

Re: [PATCH] docs: link AI coding assistants and tool-generated content pages

[Vlastimil Babka (SUSE)]

On 7/2/26 18:49, Lorenzo Stoakes wrote:
> Both of these guidelines are complimentary to one another - one specifying
> guidelines on AI coding assistants, and the other specifying those for
> tool-generated content.
> 
> Since they are complimentary to one another, provide a link to each in the
> other.
> 
> Signed-off-by: Lorenzo Stoakes <ljs@kernel.org>

Acked-by: Vlastimil Babka (SUSE) <vbabka@kernel.org>

> ---
>  Documentation/process/coding-assistants.rst | 4 ++++
>  Documentation/process/generated-content.rst | 7 +++++++
>  2 files changed, 11 insertions(+)
> 
> diff --git a/Documentation/process/coding-assistants.rst b/Documentation/process/coding-assistants.rst
> index 899f4459c52d..6125ee4914c5 100644
> --- a/Documentation/process/coding-assistants.rst
> +++ b/Documentation/process/coding-assistants.rst
> @@ -15,6 +15,10 @@ kernel development process:
>  * Documentation/process/coding-style.rst
>  * Documentation/process/submitting-patches.rst
> 
> +For guidelines on content generated by AI coding assistants see:
> +
> +* Documentation/process/generated-content.rst
> +
>  Licensing and Legal Requirements
>  ================================
> 
> diff --git a/Documentation/process/generated-content.rst b/Documentation/process/generated-content.rst
> index 08621e50a462..aad2caad9f8b 100644
> --- a/Documentation/process/generated-content.rst
> +++ b/Documentation/process/generated-content.rst
> @@ -107,3 +107,10 @@ the resulting changes.
> 
>  If you do so anyway, maintainers are entitled to reject your series
>  without detailed review.
> +
> +References
> +==========
> +
> +For specific guidelines on AI coding assistants, see:
> +
> +* Documentation/process/coding-assistants.rst
> --
> 2.55.0

Re: [PATCH] docs: link AI coding assistants and tool-generated content pages

[Lorenzo Stoakes]

On Thu, Jul 02, 2026 at 09:26:32PM +0300, Laurent Pinchart wrote:
> On Thu, Jul 02, 2026 at 05:49:01PM +0100, Lorenzo Stoakes wrote:
> > Both of these guidelines are complimentary to one another - one specifying
> > guidelines on AI coding assistants, and the other specifying those for
> > tool-generated content.
> >
> > Since they are complimentary to one another, provide a link to each in the
> > other.
> >
> > Signed-off-by: Lorenzo Stoakes <ljs@kernel.org>
> > ---
> >  Documentation/process/coding-assistants.rst | 4 ++++
> >  Documentation/process/generated-content.rst | 7 +++++++
> >  2 files changed, 11 insertions(+)
> >
> > diff --git a/Documentation/process/coding-assistants.rst b/Documentation/process/coding-assistants.rst
> > index 899f4459c52d..6125ee4914c5 100644
> > --- a/Documentation/process/coding-assistants.rst
> > +++ b/Documentation/process/coding-assistants.rst
> > @@ -15,6 +15,10 @@ kernel development process:
> >  * Documentation/process/coding-style.rst
> >  * Documentation/process/submitting-patches.rst
> >
> > +For guidelines on content generated by AI coding assistants see:
> > +
> > +* Documentation/process/generated-content.rst
> > +
>
> It could be worth it checking if this increases the likelyhood that an
> agent would include a disclosure statement in patches. I would have
> assumed that the "Attribution" section in this file to be enough. Has
> anyone ever tried to understand why it doesn't work and if it can be
> improved ?

I don't think so AFAIK.

I think people generally are aware of the Assisted-by as a thing, but perhaps
less so of the generated content guidelines, so hopefully this helps that a
little!

>
> Maybe a stronger statement would help here:
>
> "Furthermore, AI tools must follow the guidelines for generated content
> documented in Documentation/process/generated-content.rst."

I mean I would like that actually, _but_, I wanted to keep this as neutral as
possible for the time being so we can first establish the links without
controversy ;)

Then we can perhaps separately think about making the language a little more
insistent :)

>
> >  Licensing and Legal Requirements
> >  ================================
> >
> > diff --git a/Documentation/process/generated-content.rst b/Documentation/process/generated-content.rst
> > index 08621e50a462..aad2caad9f8b 100644
> > --- a/Documentation/process/generated-content.rst
> > +++ b/Documentation/process/generated-content.rst
> > @@ -107,3 +107,10 @@ the resulting changes.
> >
> >  If you do so anyway, maintainers are entitled to reject your series
> >  without detailed review.
> > +
> > +References
> > +==========
> > +
> > +For specific guidelines on AI coding assistants, see:
> > +
> > +* Documentation/process/coding-assistants.rst
>
> --
> Regards,
>
> Laurent Pinchart

Cheers, Lorenzo