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

[Lorenzo Stoakes <ljs@kernel.org>]

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