From 424d84e5a748ebeca6e8dc6b86e2a8b1479be7be Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ra=C3=BAl=20Cumplido?= Date: Mon, 26 Oct 2026 11:21:49 +0100 Subject: [PATCH 1/4] GH-55259: [Docs] Add guidelines for reviewers on AI generated PRs --- docs/source/developers/overview.rst | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/docs/source/developers/overview.rst b/docs/source/developers/overview.rst index 3b8775023236..527ebfa4772a 100644 --- a/docs/source/developers/overview.rst +++ b/docs/source/developers/overview.rst @@ -191,6 +191,21 @@ submitted contributions. See the `ASF's guidance on AI-generated code `_ for further information on licensing considerations. +We expect human contributors to actively engage on the review process. We +recognised the value of using AI tools to understand the changes being requested +but we expect a human-in-the-loop for all engagements. Reviewer time is limited +and reviewers are not expected to be talking to contributors' agents but to +contributors themselves. If a reviewer finds that a contributor seems to rely +excessively on AI tools instead of engaging with the review, the PR might be +closed and/or tagged with a label indicating excessive AI usage. An example of +message that can be left on the PR is: + + .. code:: console + + This PR doesn't appear to comply with our policy on tool-generated content. + Please see our AI generated code policy on AI-generated code: + https://arrow.apache.org/docs/developers/overview.html#ai-generated-code + .. Section on Experimental repositories: .. include:: experimental_repos.rst From 005d8f0e41a18e3149d473b9214dfd01dc30c23c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ra=C3=BAl=20Cumplido?= Date: Mon, 26 Oct 2026 11:22:30 +0100 Subject: [PATCH 2/4] Fix grammar --- docs/source/developers/overview.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/source/developers/overview.rst b/docs/source/developers/overview.rst index 527ebfa4772a..ab991798ab6c 100644 --- a/docs/source/developers/overview.rst +++ b/docs/source/developers/overview.rst @@ -192,7 +192,7 @@ submitted contributions. See the `ASF's guidance on AI-generated code information on licensing considerations. We expect human contributors to actively engage on the review process. We -recognised the value of using AI tools to understand the changes being requested +recognise the value of using AI tools to understand the changes being requested but we expect a human-in-the-loop for all engagements. Reviewer time is limited and reviewers are not expected to be talking to contributors' agents but to contributors themselves. If a reviewer finds that a contributor seems to rely From 224480a7ed6d2b598cddeb998e71c492a251c5f7 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ra=C3=BAl=20Cumplido?= Date: Mon, 26 Oct 2026 12:00:23 +0100 Subject: [PATCH 3/4] Improve formatting --- docs/source/developers/overview.rst | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/docs/source/developers/overview.rst b/docs/source/developers/overview.rst index ab991798ab6c..51a8fc6fe66e 100644 --- a/docs/source/developers/overview.rst +++ b/docs/source/developers/overview.rst @@ -197,10 +197,11 @@ but we expect a human-in-the-loop for all engagements. Reviewer time is limited and reviewers are not expected to be talking to contributors' agents but to contributors themselves. If a reviewer finds that a contributor seems to rely excessively on AI tools instead of engaging with the review, the PR might be -closed and/or tagged with a label indicating excessive AI usage. An example of -message that can be left on the PR is: +closed and/or tagged with a label indicating excessive AI usage. - .. code:: console + .. dropdown:: Example of message for a PR with excessive AI usage + :animate: fade-in-slide-down + :class-container: sd-shadow-none This PR doesn't appear to comply with our policy on tool-generated content. Please see our AI generated code policy on AI-generated code: From 30347ceaa2978b4c1e91c975e4ef65c95287385f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ra=C3=BAl=20Cumplido?= Date: Mon, 26 Oct 2026 15:06:08 +0100 Subject: [PATCH 4/4] Update docs/source/developers/overview.rst Co-authored-by: Alenka Frim --- docs/source/developers/overview.rst | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/source/developers/overview.rst b/docs/source/developers/overview.rst index 51a8fc6fe66e..76445724e92a 100644 --- a/docs/source/developers/overview.rst +++ b/docs/source/developers/overview.rst @@ -199,13 +199,13 @@ contributors themselves. If a reviewer finds that a contributor seems to rely excessively on AI tools instead of engaging with the review, the PR might be closed and/or tagged with a label indicating excessive AI usage. - .. dropdown:: Example of message for a PR with excessive AI usage - :animate: fade-in-slide-down - :class-container: sd-shadow-none +.. dropdown:: Example of message for a PR with excessive AI usage + :animate: fade-in-slide-down + :class-container: sd-shadow-none - This PR doesn't appear to comply with our policy on tool-generated content. - Please see our AI generated code policy on AI-generated code: - https://arrow.apache.org/docs/developers/overview.html#ai-generated-code + This PR doesn't appear to comply with our policy on tool-generated content. + Please see our AI generated code policy on AI-generated code: + https://arrow.apache.org/docs/developers/overview.html#ai-generated-code .. Section on Experimental repositories: