Skip to content

MAINT: add AI disclosure to pr template#31124

Open
story645 wants to merge 2 commits intomatplotlib:mainfrom
story645:pr-template
Open

MAINT: add AI disclosure to pr template#31124
story645 wants to merge 2 commits intomatplotlib:mainfrom
story645:pr-template

Conversation

@story645
Copy link
Member

@story645 story645 commented Feb 9, 2026

PR summary

Jumping off the discussion in #30848 and my wanting to add a disclosure to a PR to model the behavior I want to see, added a section on AI disclosure cause that seemed the easiest. Going simple here in the spirit of #30848 (comment) and we can always add more later.

PR checklist

@rcomer
Copy link
Member

rcomer commented Feb 9, 2026

Is this instead of #31043, or in addition?

@story645
Copy link
Member Author

story645 commented Feb 9, 2026

Is this instead of #31043, or in addition?

In addition - we want all contributors to disclose AI and we want to reassure new contributors it's so we can give 'em good feedback (which is why I didn't put it here)

Probably should have just added to that PR but was thinking of them as separate discussions/tasks.

@story645 story645 force-pushed the pr-template branch 4 times, most recently from f62c7d6 to 585373d Compare February 9, 2026 21:54
Copy link
Member

@rcomer rcomer left a comment

Choose a reason for hiding this comment

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

Does this count as docs, or do we need two approvals?

@story645
Copy link
Member Author

story645 commented Feb 10, 2026

Does this count as docs, or do we need two approvals?

🤷‍♀️ I'm fine w/ more than one as it's kinda an implicit policy change.

Copy link
Member

@timhoffm timhoffm left a comment

Choose a reason for hiding this comment

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

Good as a starting point. It's still a bit vauge:

  • "used AI in writing this PR": Does this mean the code or the PR description or both? Do we need to be more explicit?

  • "please describe how" also leaves room for interpretation and may be difficult to answer for someone who is serious about it. Likely we only want to know "for getting ideas" / "for writing the code" / "for rewording the PR message" / "I promted AI to solve the problem" / "I told an agent to find and fix FOSS issues". But one could answer much more detailed.

    As a minimal improvement maybe "please briefly describe" how.

Overall, I think we need to gradually improve on the topic.

@story645
Copy link
Member Author

story645 commented Feb 11, 2026

Does this mean the code or the PR description or both? Do we need to be more explicit?

it's purposely broad - I wanna see what responses we get before fine tuning, and also we do care about both.

also leaves room for interpretation and may be difficult to answer for someone who is serious about it.

Again trying to leave space for openness - we'd rather someone tell us about AI use we don't care about (research) than not tell us about AI we do.


## AI Disclosure
<!-- If you used AI in writing this PR, please briefly describe how.
Please review our policy at
Copy link
Member

Choose a reason for hiding this comment

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

Should the verb rather be read or follow or ...? "Review" sounds a bit like the user should give feedback on the policy. It may be technical correct but in the context of PRs "review" has a default connotation. At least I Asia non-native speaker have been stumbling over this.

Copy link
Member Author

Choose a reason for hiding this comment

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

I meant it more like how you review material for an exam, but changed it to read.

@story645
Copy link
Member Author

@rcomer added your wording from #30848 (comment) to the second commit

story645 and others added 2 commits February 12, 2026 16:06
Co-authored-by: Ruth Comer <10599679+rcomer@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[MNT]: Should we request contributors to declare usage of AI?

3 participants