Skip to content

Conversation

@story645
Copy link
Member

PR summary

Adds an admonition summarizing the policy and linking to it under policies and guidelines on the dev landing page, per
#30439 (comment)

closes #30439

PR checklist

@github-actions github-actions bot added the Documentation: devdocs files in doc/devel label Oct 28, 2025
Comment on lines 194 to 195
Use AI tools as reference aides, not to author contributions in your stead. For
guidance, see our :ref:`AI policy <generative_ai>`.
Copy link
Member

Choose a reason for hiding this comment

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

I'm not quite clear, whether that reflects our policy. Maybe it's because "reference aides" and "author contributions in your stead" sounds a bit formal and academic to my ears. I would translate this to

Suggested change
Use AI tools as reference aides, not to author contributions in your stead. For
guidance, see our :ref:`AI policy <generative_ai>`.
AI tools may be used for reference or inspiration, but you must personally
author all submitted work. See our :ref:`AI policy <generative_ai>`.

But our policy does not explicitly prohibit to submit AI content. I read

If you use generative AI tools as an aid in developing code or documentation changes, ensure that you fully understand the proposed changes and can explain why they are the correct approach and an improvement to the current state.

more in that any potentially AI generated content must be reviewed, evaluated and curated before submission. - But maybe the point is that we are not very clear what is acceptable and what not.

That said, I'm not very clear

Copy link
Member Author

@story645 story645 Oct 30, 2025

Choose a reason for hiding this comment

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

sounds a bit formal and academic to my ears.

Sort of the intent? The colloquial form is "You can use AI to look things up, not to write the contribution for you" or "Use AI to help you, not make the contribution for you"

Which, maybe we should just be that direct? I think reference & inspiration are interchangeable here.

But maybe the point is that we are not very clear what is acceptable and what not.

Yeah, I think that's the bigger problem. Fundamentally we'd merge a bot authored PR if it actually resolved the issue. It's just that what folks are submitting doesn't.

Copy link
Member Author

Choose a reason for hiding this comment

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

Also the complexity of communicating the policy is why I'm thinking it may make more sense to just move the policy from contributing to the dev landing page as a subsection of policies and guidelines (under the toc boxes). Don't love it cause of scope creep but it applies to everything on the page.

Copy link
Member

Choose a reason for hiding this comment

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

What about something like

AI generated content is often wrong. Always evaluate and correct it before submitting.

Copy link
Member

@timhoffm timhoffm Nov 18, 2025

Choose a reason for hiding this comment

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

How about

Suggested change
Use AI tools as reference aides, not to author contributions in your stead. For
guidance, see our :ref:`AI policy <generative_ai>`.
We expect original effort and engagement for all contributions. AI may be
used responsibly as a supportive tool, but must not be appplied blindly.
For guidance, please refer to our :ref:AI policy <generative_ai>.

Copy link
Member Author

Choose a reason for hiding this comment

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

Let me see if I can get that down to something about half the length.

Copy link
Member Author

Choose a reason for hiding this comment

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

my intent is to shift the heavy lifting of defining "authentic engagement" to the long form policy. I think trying to define it in the note is where we get into trouble here.

@timhoffm timhoffm merged commit 91b8a07 into matplotlib:main Nov 19, 2025
21 checks passed
@QuLogic QuLogic added this to the v3.11.0 milestone Nov 20, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Documentation: devdocs files in doc/devel

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Doc]: Link AI policy on contributing page

4 participants