Thanks to visit codestin.com
Credit goes to github.com

Skip to content

DOC: Impove AI policy#31459

Merged
timhoffm merged 1 commit intomatplotlib:mainfrom
timhoffm:doc-ai-policy
Apr 8, 2026
Merged

DOC: Impove AI policy#31459
timhoffm merged 1 commit intomatplotlib:mainfrom
timhoffm:doc-ai-policy

Conversation

@timhoffm
Copy link
Copy Markdown
Member

@timhoffm timhoffm commented Apr 6, 2026

Closes #31454.

AI Disclosure

No AI used.

@github-actions github-actions Bot added the Documentation: devdocs files in doc/devel label Apr 6, 2026
Comment thread doc/devel/contribute.rst Outdated
Comment thread doc/devel/contribute.rst Outdated
Comment thread doc/devel/contribute.rst Outdated
Comment thread doc/devel/contribute.rst Outdated
Comment thread doc/devel/contribute.rst Outdated
Comment thread doc/devel/contribute.rst Outdated
Comment thread doc/devel/contribute.rst Outdated
We expect authentic engagement in our community. Make sure you have added value
based on your personal competency to your contributions.

**Acceptable uses** include
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.

Maybe go simpler: OK/Not OK ? Maybe even a table like this policy @melissawm shared:
https://github.com/uaanchorage/GSoC/blob/main/Acceptable-and-Ethical-AI-Use-Policy.md

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

OK, not ok feels too flat. Also I want to indicate that these are only examples and not an exhaustive list. The "include" phrasing should indicate that.

I don't like the table, because its rows are designed as good and bad behavior for a specific topic. Our exemplary approach does not match to that (What's the don't part of "Gaining understanding of the existing code").

We could make two columns with bullet points if you think a left-right separation will visually contrast the good-bad parts better.

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.

What's the don't part of "Gaining understanding of the existing code

feeding the issue into the AI and using what it spits back w/o interrogation

but there's something about unacceptable/acceptable that to me feels a bit indirect

We could make two columns with bullet points if you think a left-right separation will visually contrast the good-bad parts better.

Yeah, I think that'd work better to not have things lost. Maybe a "Good" card highlighting assistive uses and a "bad" card highlighting "AI doing it for you" uses. We can then also include the check/x icons in the headers

✅ Acceptable Uses | ❌ Unacceptable Uses

Comment thread doc/devel/contribute.rst Outdated
Comment thread doc/devel/contribute.rst Outdated
Comment thread doc/devel/contribute.rst Outdated
We expect authentic engagement in our community. Make sure you have added value
based on your personal competency to your contributions.

**Acceptable uses** include
Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

OK, not ok feels too flat. Also I want to indicate that these are only examples and not an exhaustive list. The "include" phrasing should indicate that.

I don't like the table, because its rows are designed as good and bad behavior for a specific topic. Our exemplary approach does not match to that (What's the don't part of "Gaining understanding of the existing code").

We could make two columns with bullet points if you think a left-right separation will visually contrast the good-bad parts better.

Comment thread doc/devel/contribute.rst Outdated
Comment thread doc/devel/contribute.rst Outdated
Comment thread doc/devel/contribute.rst Outdated
Comment thread doc/devel/contribute.rst Outdated
@timhoffm timhoffm force-pushed the doc-ai-policy branch 2 times, most recently from 7e292f0 to 516246d Compare April 7, 2026 22:11
Comment thread doc/devel/contribute.rst Outdated
Comment on lines +191 to +196
Generative AI tools have evolved rapidly, and their suggested results can be
helpful. As with using any tool, the resulting contribution is the responsibility
of the contributor. Discretion, good judgment, and critical thinking are the
foundation of all good contributions, regardless of the tools used in their
creation. We expect authentic engagement in our community. Make sure you have
added value based on your personal competency to your contributions.
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 found this paragraph a bit awkward, but feel free to keep or ignore my suggestion which may be equally so. I didn't dare ask Claude to clean it up.

Suggested change
Generative AI tools have evolved rapidly, and their suggested results can be
helpful. As with using any tool, the resulting contribution is the responsibility
of the contributor. Discretion, good judgment, and critical thinking are the
foundation of all good contributions, regardless of the tools used in their
creation. We expect authentic engagement in our community. Make sure you have
added value based on your personal competency to your contributions.
Generative AI tools are evolving rapidly, and can be helpful tools when interacting with the project. As with any tool, the resulting contribution is the responsibility
of the contributor, and should be used in conjunction with discretion, good judgment and critical thinking. We expect authentic engagement in our community that should not be bypassed by using agents or other crutches.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

Changed to new wording:

Generative AI tools are evolving rapidly, and can be helpful tools. As with any
tool, the resulting contribution is the responsibility of the contributor. We
expect dedicated and authentic engagment in our community. In particular when
using AI, carefully consider what and how to communicate, question results,
think things through thoroughly and make well-informed decisions.

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.

think things through thoroughly, and make well-informed decisions.

I'm biased towards the oxford comma.

Comment thread doc/devel/contribute.rst Outdated
Copy link
Copy Markdown
Member

@jklymak jklymak left a comment

Choose a reason for hiding this comment

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

Looks good to me, and I think strikes a good tone.

@timhoffm timhoffm force-pushed the doc-ai-policy branch 3 times, most recently from 9ac1f37 to 7643e53 Compare April 7, 2026 22:53
Copy link
Copy Markdown
Member

@story645 story645 left a comment

Choose a reason for hiding this comment

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

Pure nits but otherwise definitely think this is an improvement.

Comment thread doc/devel/contribute.rst Outdated
Comment thread doc/devel/contribute.rst Outdated
Comment on lines +192 to +193
tool, the resulting contribution is the responsibility of the contributor. We
expect dedicated and authentic engagment in our community. In particular when
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.

Suggested change
tool, the resulting contribution is the responsibility of the contributor. We
expect dedicated and authentic engagment in our community. In particular when
tool, the resulting contribution is the responsibility of the contributor. In particular when

The "dedicated and authentic" feels a bit fragmenty to me b/c of the in particular

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

I'd like to keep "dedicated and authentic. The previous sentence attributes responsibility, and I'd like to stress the expectation of engagement. It's on the upper end of the pathos scale (to not say pathetic, because I don't intend the negative connotation of that), but that intentional to give a moral founding. Just stating the practical behaviors feels too weak.

@timhoffm timhoffm force-pushed the doc-ai-policy branch 2 times, most recently from 3a11981 to 4c082af Compare April 7, 2026 23:30
- Change title from "Restrictions ..." to "Usage ..." which is more neutral
- Introductory paragraph copied from https://devguide.python.org/getting-started/generative-ai/#generative-ai (CC0 license) - I find this a very good high-level summary of the mindset
- Add lists of acceptable and unacceptable uses
@timhoffm
Copy link
Copy Markdown
Member Author

timhoffm commented Apr 8, 2026

This has become quite good! - Thanks for the input from the reviews. 🙇

@timhoffm timhoffm merged commit d84c7ee into matplotlib:main Apr 8, 2026
21 checks passed
@timhoffm timhoffm deleted the doc-ai-policy branch April 8, 2026 00:14
@timhoffm timhoffm added this to the v3.11.0 milestone Apr 8, 2026
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]: Amend AI policy by a concrete list of dos and don’ts

3 participants