From 83f71fbc66fbce7b93b13b64105315bfb1f70605 Mon Sep 17 00:00:00 2001 From: Akira Yokosawa Date: Thu, 2 Jul 2026 19:44:15 +0900 Subject: docs: submitting-patches: Fix section structure around DCO Commit 5903019b2a5e ("Documentation/SubmittingPatches: convert it to ReST markup") made "DCO 1.1" a subsection under the section "Sign your work - ...". However, the DCO text is meant to be referenced in the section. Furthermore, in HTML and PDF docs, paragraphs following the DCO: then you just add a line saying: Signed-off-by: [...] [...] as it was propagated to the maintainers and ultimately to Linus, with the first SoB entry signalling primary authorship of a single author. appear to belong to the DCO, rather than to "Sign your work - ..." where it should. In reST (and other documentation tools), once you start a subsection under a section, there is no way to go back to the section. Fix the section structure by making the DCO a literal block, with indent changes made in commit 5903019b2a5e reverted. While at it, fix the same issue at "Reviewer's statement of oversight". Signed-off-by: Akira Yokosawa Tested-by: Randy Dunlap Acked-by: Randy Dunlap Signed-off-by: Jonathan Corbet Message-ID: <5f320260-5cb0-42cc-949a-c92404124618@gmail.com> --- Documentation/process/submitting-patches.rst | 14 ++++++-------- 1 file changed, 6 insertions(+), 8 deletions(-) (limited to 'Documentation/process') diff --git a/Documentation/process/submitting-patches.rst b/Documentation/process/submitting-patches.rst index cc6a1f73d7f2..7ae79452e1b4 100644 --- a/Documentation/process/submitting-patches.rst +++ b/Documentation/process/submitting-patches.rst @@ -404,12 +404,11 @@ patches that are being emailed around. The sign-off is a simple line at the end of the explanation for the patch, which certifies that you wrote it or otherwise have the right to pass it on as an open-source patch. The rules are pretty simple: if you -can certify the below: +can certify the below:: -Developer's Certificate of Origin 1.1 -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + Developer's Certificate of Origin 1.1 -By making a contribution to this project, I certify that: + By making a contribution to this project, I certify that: (a) The contribution was created in whole or in part by me and I have the right to submit it under the open source license @@ -554,12 +553,11 @@ some testing has been performed, provides a means to locate testers for future patches, and ensures credit for the testers. Reviewed-by:, instead, indicates that the patch has been reviewed and found -acceptable according to the Reviewer's Statement: +acceptable according to the Reviewer's Statement:: -Reviewer's statement of oversight -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + Reviewer's statement of oversight -By offering my Reviewed-by: tag, I state that: + By offering my Reviewed-by: tag, I state that: (a) I have carried out a technical review of this patch to evaluate its appropriateness and readiness for inclusion into -- cgit From d699a5da103942fdc0a8a5383359bdec01fc19dd Mon Sep 17 00:00:00 2001 From: Lorenzo Stoakes Date: Thu, 2 Jul 2026 17:49:01 +0100 Subject: 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. Signed-off-by: Lorenzo Stoakes Acked-by: Vlastimil Babka (SUSE) Reviewed-by: Greg Kroah-Hartman Acked-by: SJ Park Reviewed-by: David Hildenbrand (Arm) Reviewed-by: Jeff Layton Signed-off-by: Jonathan Corbet Message-ID: <20260702164901.121128-1-ljs@kernel.org> --- Documentation/process/coding-assistants.rst | 4 ++++ Documentation/process/generated-content.rst | 7 +++++++ 2 files changed, 11 insertions(+) (limited to 'Documentation/process') 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 -- cgit From 816d9992d9ed434ec52cfbd63080d518e535a41b Mon Sep 17 00:00:00 2001 From: Christian Brauner Date: Wed, 1 Jul 2026 17:54:48 +0200 Subject: coding-assistants: simplify attribution The requirement to identify specific models used in the Assisted-by tag provides free advertising to proprietary software companies while adding little or no useful information. Change the requirement to simply: Assisted-by: LLM to capture the fact that an LLM was used without tracking which one. Signed-off-by: Christian Brauner (Amutable) Reviewed-by: Lorenzo Stoakes (ARM) Reviewed-by: Jeff Layton Reviewed-by: Jori Koolstra Reviewed-by: Mauro Carvalho Chehab Reviewed-by: David Hildenbrand (arm) Message-ID: <20260701-work-coding-assistants-v1-1-a20a94d1d606@kernel.org> Signed-off-by: Jonathan Corbet --- Documentation/process/coding-assistants.rst | 8 ++------ 1 file changed, 2 insertions(+), 6 deletions(-) (limited to 'Documentation/process') diff --git a/Documentation/process/coding-assistants.rst b/Documentation/process/coding-assistants.rst index 6125ee4914c5..e62c9577d91a 100644 --- a/Documentation/process/coding-assistants.rst +++ b/Documentation/process/coding-assistants.rst @@ -47,12 +47,8 @@ When AI tools contribute to kernel development, proper attribution helps track the evolving role of AI in the development process. Contributions should include an Assisted-by tag in the following format:: - Assisted-by: AGENT_NAME:MODEL_VERSION [TOOL1] [TOOL2] + Assisted-by: LLM [TOOL1] [TOOL2] -Where: - -* ``AGENT_NAME`` is the name of the AI tool or framework -* ``MODEL_VERSION`` is the specific model version used * ``[TOOL1] [TOOL2]`` are optional specialized analysis tools used (e.g., coccinelle, sparse, smatch, clang-tidy) @@ -60,4 +56,4 @@ Basic development tools (git, gcc, make, editors) should not be listed. Example:: - Assisted-by: Claude:claude-3-opus coccinelle sparse + Assisted-by: LLM coccinelle sparse -- cgit