Skip to content

Document AI policy labels and when to use them - #1933

Merged
Mariatta merged 3 commits into
python:mainfrom
zanieb:document-ai-policy-labels
Oct 27, 2026
Merged

Mariatta merged 3 commits into
python:mainfrom
zanieb:document-ai-policy-labels

Conversation

@zanieb

@zanieb zanieb commented Oct 23, 2026

Copy link
Copy Markdown
Contributor

@read-the-docs-community

read-the-docs-community Bot commented Oct 23, 2026 •

Copy link
Copy Markdown

Documentation build overview

📚 CPython devguide | 🛠️ Build #35454140 | 📁 Comparing 183ece2 against latest (03909b3)

  🔍 Preview build  

1 file changed
± triage/labels/index.html

@StanFromIreland StanFromIreland left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Will merge once they land.

@willingc willingc left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for taking this on @zanieb

Comment thread triage/labels.rst Outdated
Comment thread triage/labels.rst Outdated
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Comment thread triage/labels.rst Outdated
Other labels
============

* Use :gh-label:`AI policy close <AI%20policy%20close>` for a clearly low-effort

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In python/bedevere#722 (comment) I suggested alternative labels:

ai-needs-explanation instead of AI policy comment
ai-not-acceptable instead of AI policy close

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We should also mention these labels in the AI policy doc itself to explain how we will react and enforce to AI-assisted contributions. Additionally, triaging doc could benefit from this additional checklist.

Comment thread triage/labels.rst Outdated
feedback. The bot links to the :ref:`guidelines for using AI tools
<ai-tools>` and closes the issue or PR. See the :ref:`triage team's guidance
on closing PRs <triage-team>`.
* Use :gh-label:`AI policy comment <AI%20policy%20comment>` when you have concerns

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I suggest giving a timeframe that if they aren't responsive after some time, then it should be closed.

Will we then remove the need explanation label and add the not acceptable label? So only one of the two labels can exist?

The labels were renamed to AI-needs-explanation and AI-guidelines-not-met,
matching the names bedevere now acts on.
@Mariatta

Copy link
Copy Markdown
Member

I pushed a new commit here, to reflect the actual AI- labels: AI-needs-explanation and AI-guidelines-not-met.

@Mariatta
Mariatta merged commit ef89264 into python:main Oct 27, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants