Movatterモバイル変換


[0]ホーム

URL:


Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

[DOC] dev landing page admonition about AI usage/link to policy#30699

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to ourterms of service andprivacy statement. We’ll occasionally send you account related emails.

Already on GitHub?Sign in to your account

Open
story645 wants to merge1 commit intomatplotlib:main
base:main
Choose a base branch
Loading
fromstory645:ai-note
Open
Changes fromall commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 7 additions & 2 deletionsdoc/devel/index.rst
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -189,8 +189,13 @@ and managing a development environment and workflow:
Policies and guidelines
=======================

These policies and guidelines help us maintain consistency in the various types
of maintenance work. If you are writing code or documentation, following these policies
.. admonition:: AI Usage

Use AI tools as reference aides, not to author contributions in your stead. For
guidance, see our :ref:`AI policy <generative_ai>`.
Comment on lines +194 to +195
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
UseAI toolsas reference aides, not to author contributions in your stead. For
guidance, see our:ref:`AI policy<generative_ai>`.
AI toolsmay 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
MemberAuthor

@story645story645Oct 30, 2025
edited
Loading

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
MemberAuthor

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.

story645 reacted with thumbs up emoji

These policies and guidelines help us maintain consistency in the various types of
maintenance work. If you are writing code or documentation, following these policies
helps maintainers more easily review your work. If you are helping triage, community
manage, or release manage, these guidelines describe how our current process works.

Expand Down

[8]ページ先頭

©2009-2025 Movatter.jp