Skip to contentSkip to conversation

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

PATCH In review Lorenzo Stoakes 8 participants 9 messages Jul 2 – Jul 22

Subsystems (3)
lore
Share & tools
lore
#0 lore raw

PATCH 1/1 docs: link AI coding assistants and tool-generated content pages

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.

---
 Documentation/process/coding-assistants.rst | 4 ++++
 Documentation/process/generated-content.rst | 7 +++++++
 2 files changed, 11 insertions(+)
Documentation/process/coding-assistants.rst +4 -0
index 899f4459c52d..6125ee4914c5 100644
@@ -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
 ================================
 
Documentation/process/generated-content.rst +7 -0
index 08621e50a462..aad2caad9f8b 100644
@@ -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 on v1 1/1
#1 lore raw
Quoted 44 lines · 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.

---
 Documentation/process/coding-assistants.rst | 4 ++++
 Documentation/process/generated-content.rst | 7 +++++++
 2 files changed, 11 insertions(+)
Documentation/process/coding-assistants.rst +4 -0
index 899f4459c52d..6125ee4914c5 100644
@@ -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
 ================================
 
Documentation/process/generated-content.rst +7 -1
index 08621e50a462..aad2caad9f8b 100644
@@ -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
--
Quoted 1 line

2.55.0

Reviewed-by on v1 1/1
#2 lore raw
In reply to Lorenzo Stoakes
Quoted 9 lines · 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.

---

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

Signature · 3 lines
Cheers,

David
#3 lore raw
In reply to Lorenzo Stoakes
Quoted 18 lines · 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.

---
 Documentation/process/coding-assistants.rst | 4 ++++
 Documentation/process/generated-content.rst | 7 +++++++
 2 files changed, 11 insertions(+)
Documentation/process/coding-assistants.rst +0 -0
index 899f4459c52d..6125ee4914c5 100644

Documentation/process/coding-assistants.rst kernel development process: · line 21

Quoted 7 lines
Documentation/process/coding-assistants.rst +4 -0
@@ -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."

Quoted 18 lines
Documentation/process/coding-assistants.rst +0 -0
 Licensing and Legal Requirements
 ================================
 
Documentation/process/generated-content.rst +7 -0
index 08621e50a462..aad2caad9f8b 100644
@@ -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
Signature · 3 lines
Regards,

Laurent Pinchart
#4 lore raw
Quoted 22 lines · Laurent Pinchart
Quoted 21 lines · 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.

---
 Documentation/process/coding-assistants.rst | 4 ++++
 Documentation/process/generated-content.rst | 7 +++++++
 2 files changed, 11 insertions(+)
Documentation/process/coding-assistants.rst +0 -0
index 899f4459c52d..6125ee4914c5 100644
@@ -15,6 +15,10 @@ kernel development process:
 * Documentation/process/coding-style.rst
 * Documentation/process/submitting-patches.rst
 
Quoted 10 lines

Documentation/process/coding-assistants.rst kernel development process: · line 21

Quoted 4 lines
Documentation/process/coding-assistants.rst +4 -0
+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!

Quoted 5 lines

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 :)

Quoted 23 lines
Quoted 9 lines
Documentation/process/coding-assistants.rst +0 -0
 Licensing and Legal Requirements
 ================================
 
Documentation/process/generated-content.rst +0 -0
index 08621e50a462..aad2caad9f8b 100644

Documentation/process/generated-content.rst the resulting changes. · line 116

Quoted 10 lines
Documentation/process/generated-content.rst +7 -0
@@ -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,

Quoted 1 line

Laurent Pinchart

Cheers, Lorenzo

Acked-by on v1 1/1
#5 lore raw
In reply to Lorenzo Stoakes
Quoted 6 lines · On Thu, 2 Jul 2026 17:49:01 +0100 Lorenzo Stoakes <[email protected]> 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.

Quoted 2 lines
Quoted 10 lines
---
 Documentation/process/coding-assistants.rst | 4 ++++
 Documentation/process/generated-content.rst | 7 +++++++
 2 files changed, 11 insertions(+)
Documentation/process/coding-assistants.rst +0 -0
index 899f4459c52d..6125ee4914c5 100644

Documentation/process/coding-assistants.rst kernel development process: · line 18

Quoted 4 lines
Documentation/process/coding-assistants.rst +1 -0
@@ -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?

Quoted 11 lines
Documentation/process/coding-assistants.rst +3 -0
+
+* Documentation/process/generated-content.rst
+
 Licensing and Legal Requirements
 ================================
 
Documentation/process/generated-content.rst +0 -0
index 08621e50a462..aad2caad9f8b 100644

Documentation/process/generated-content.rst the resulting changes. · line 114

Quoted 8 lines
Documentation/process/generated-content.rst +5 -0
@@ -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

[...]

Reviewed-by Greg Kroah-Hartman on v1 1/1
#6 lore raw
In reply to Lorenzo Stoakes
Quoted 4 lines · 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.

Quoted 9 lines

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

---
 Documentation/process/coding-assistants.rst | 4 ++++
 Documentation/process/generated-content.rst | 7 +++++++
 2 files changed, 11 insertions(+)
Acked-by on v1 1/1
#7 lore raw
In reply to Lorenzo Stoakes
Quoted 8 lines · 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.

Quoted 37 lines
---
 Documentation/process/coding-assistants.rst | 4 ++++
 Documentation/process/generated-content.rst | 7 +++++++
 2 files changed, 11 insertions(+)
Documentation/process/coding-assistants.rst +4 -0
index 899f4459c52d..6125ee4914c5 100644
@@ -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
 ================================
 
Documentation/process/generated-content.rst +7 -1
index 08621e50a462..aad2caad9f8b 100644
@@ -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

maintainer
#8 lore raw
In reply to Lorenzo Stoakes
Quoted 4 lines · 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.

Quoted 8 lines

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

---
 Documentation/process/coding-assistants.rst | 4 ++++
 Documentation/process/generated-content.rst | 7 +++++++
 2 files changed, 11 insertions(+)

Applied (finally), thanks.

jon