Skip to content

Commit 1d71f45

Browse files
Mariattahugovk
andauthored
Update Docs about AI policy enforcement (#1947)
* Update Docs about AI policy enforcement Update AI policy guidelines doc to explain how we are enforcing this policy. Update triaging docs to add checklist and guidance on how to triage ai-assisted contributions. Closes #1935 * Add escalation step and link both AI label entries to the guidance * Recommend applying only one AI policy label at a time * Update triage/triage-team.rst Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com> --------- Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
1 parent ef89264 commit 1d71f45

4 files changed

Lines changed: 53 additions & 2 deletions

File tree

‎getting-started/ai-tools.rst‎

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -62,3 +62,18 @@ disrespectful of the maintainers time.
6262
It is not acceptable to alter or bypass existing tests, or remove desired
6363
functionality, in order to make a failing test pass. Such changes are not
6464
a real fix.
65+
66+
How these guidelines are applied
67+
================================
68+
69+
Using AI tools is not a reason on its own for an issue or PR to be labeled
70+
or closed. When a maintainer thinks an issue or PR does not follow these
71+
guidelines, they may apply one of the following labels. A bot then posts a
72+
comment that links to this page.
73+
74+
- :gh-label:`AI-needs-explanation`: the issue or PR stays open. Reply in your
75+
own words: explain what the change does or what the issue is about, and
76+
describe how you checked that it is correct.
77+
- :gh-label:`AI-guidelines-not-met`: the issue or PR is closed. If you think
78+
we misunderstood your contribution, reply on the issue or PR. You are
79+
welcome to explain your approach or ask questions about these guidelines.

‎triage/labels.rst‎

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -120,10 +120,12 @@ Other labels
120120
AI-assisted submission where you think the author is unlikely to engage with
121121
feedback. The bot links to the :ref:`guidelines for using AI tools
122122
<ai-tools>` and closes the issue or PR. See the :ref:`triage team's guidance
123-
on closing PRs <triage-team>`.
123+
on applying the AI policy labels <triage-ai-labels>`.
124124
* Use :gh-label:`AI-needs-explanation` when you have concerns
125125
about AI-assisted work and think the author is likely to engage with feedback.
126-
The bot posts a reminder and leaves the issue or PR open.
126+
The bot posts a reminder and leaves the issue or PR open. See the
127+
:ref:`triage team's guidance on applying the AI policy labels
128+
<triage-ai-labels>`.
127129
* :gh-label:`build`/:gh-label:`performance`: for issues related
128130
to the build process or performance, respectively.
129131
* :gh-label:`easy`: for issues that are considered easy.

‎triage/triage-team.rst‎

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -56,6 +56,38 @@ the Python Software Foundation, always follow the `PSF Code of Conduct`_.
5656
.. _PSF Code of Conduct: https://policies.python.org/python.org/code-of-conduct/
5757

5858

59+
.. _triage-ai-labels:
60+
61+
Applying the AI policy labels
62+
=============================
63+
64+
Use the AI policy labels for issues and PRs that don't follow the
65+
:ref:`guidelines for using AI tools <ai-tools>`. Don't apply them only because
66+
AI tools were used, or because the author disclosed using them.
67+
68+
Apply only one of these labels to an issue or PR. If you add one when the
69+
other is already there, remove the other label.
70+
71+
* Start with :gh-label:`AI-needs-explanation`. The bot asks the author to
72+
explain the work in their own words and leaves the issue or PR open.
73+
* Use :gh-label:`AI-guidelines-not-met` only for clear cases, such as a
74+
low-effort submission where the author is unlikely to engage with feedback.
75+
The bot posts a comment and closes the issue or PR. If you have any doubt,
76+
use :gh-label:`AI-needs-explanation` instead, or consult a core developer.
77+
* If the author doesn't respond to :gh-label:`AI-needs-explanation`, or the
78+
response doesn't address the concern (for example, it is more generated
79+
text), remove :gh-label:`AI-needs-explanation` and add
80+
:gh-label:`AI-guidelines-not-met`. The bot posts the closing
81+
comment and closes the issue or PR. If you have any doubt, consult a core
82+
team member first.
83+
* If the author responds and the concern is resolved, remove the label.
84+
For a closed issue or PR, reopen it as well.
85+
86+
Prefer these labels over closing manually, so the author gets the same
87+
explanation each time and the issues and PRs can be found later by filtering
88+
on the label.
89+
90+
5991
Becoming a member of the Python triage team
6092
===========================================
6193

‎triage/triaging.rst‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -28,6 +28,8 @@ Checklist for triaging
2828
* If the issue is clearly invalid (unrelated to CPython, spam, and
2929
so on), you can use GitHub's :guilabel:`Close as not planned` option
3030
and apply the :gh-label:`invalid` label.
31+
* If the issue or PR doesn't follow the :ref:`guidelines for using AI tools
32+
<ai-tools>`, apply one of the :ref:`AI policy labels <triage-ai-labels>`.
3133

3234

3335
.. _triage-fields:

0 commit comments

Comments
 (0)