Skip to content

add ai policy to contributing.md - #4835

Open
vadosnaprimer wants to merge 12 commits into
TASEmulators:masterfrom
vadosnaprimer:genai
Open

add ai policy to contributing.md#4835
vadosnaprimer wants to merge 12 commits into
TASEmulators:masterfrom
vadosnaprimer:genai

Conversation

@vadosnaprimer

@vadosnaprimer vadosnaprimer commented Sep 7, 2026

Copy link
Copy Markdown
Contributor

Text very loosely based on https://github.com/libsdl-org/SDL/blob/main/AGENTS.md

@vadosnaprimer vadosnaprimer linked an issue Sep 7, 2026 that may be closed by this pull request
adelikat
adelikat previously approved these changes Sep 7, 2026
@YoshiRulz YoshiRulz added the Meta Relating to code organisation or to things that aren't code label Sep 7, 2026
YoshiRulz

This comment was marked as outdated.

@vadosnaprimer

This comment was marked as outdated.

@vadosnaprimer
vadosnaprimer dismissed YoshiRulz’s stale review September 7, 2026 17:33

Empty request for changes is disruptive.

YoshiRulz

This comment was marked as outdated.

@vadosnaprimer
vadosnaprimer marked this pull request as draft September 7, 2026 18:00
@vadosnaprimer vadosnaprimer changed the title Create AGENTS.md add ai policy to contributing.md Sep 7, 2026
@vadosnaprimer

Copy link
Copy Markdown
Contributor Author

There.

@vadosnaprimer

Copy link
Copy Markdown
Contributor Author

Added checkboxes to issues and PRs for good measure. Requiring disclosure is an iffy subject because it may make it harder to distinguish blatant violations from people who properly used AI. If they haven't used it at all, they will check the box. If they used it in some way, only having the blanket checkbox would attempt to force them to describe in human text how it was involved. And if it's silently ignored or removed, we'll know it's suspicious and ask direct questions.

@vadosnaprimer
vadosnaprimer marked this pull request as ready for review September 7, 2026 19:27
Comment thread .github/ISSUE_TEMPLATE/30-bug_report.md Outdated
Comment thread contributing.md

Submoduling third-party code that involves output of the generative AI is allowed if there is no viable alternative free from generative AI.

Using generative AI as a tool to aid with your research prior to submitting content to this repository is only allowed if that content does not include any AI hallucinations: bug reports and proposed fixes must be valid and sensible.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Do we want people to state in issues or pull requests when they use generative AI in this way?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

I think the wording of the checbox solves it, as explained in my post above.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

I disagree. Intentionally leaving out information about what you want from other people should not be expected to result in other people doing what you want, nor should it be expected to encourage good communication.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

What should be expected then?

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Disappointment, frustration, and/or disengagement.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Not seeing it, please make an example scenario.

Comment thread .github/ISSUE_TEMPLATE/30-bug_report.md Outdated
Comment thread .github/ISSUE_TEMPLATE/70-core_port_request.md Outdated
Comment thread contributing.md
Comment thread contributing.md

## Generative AI policy

Content created by generative AI, including large language models (LLMs), should not be submitted to this repository. That involves text and media files, issues and pull requests.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Is AI translation permitted?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Translation is technically not generation of thoughts that are actually being conveyed. Unlike tasvideos the site, we don't have to go out of our way to support non-native speakers. But if it's used, we could tolerate that. I don't feel it needs a mention in the policy, let it remain vague, to encourage clarification.

@YoshiRulz YoshiRulz Sep 8, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

I don't like vague policies.

+If you are not fluent in English, you may use machine translation when submitting an issue or PR, so long as your original text is included.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

When adding a line such as this, it often also helps to mention something along the lines of

+Your English does not need to be perfect. We prefer slightly broken English over machine translations. However, if that doesn't suffice, you may use machine translation when submitting an issue or PR, so long as your original text is included.

Either that, or don't mention it at all, as to not entice people to use machine translations when not needed.

vadosnaprimer and others added 2 commits September 8, 2026 20:30
Co-authored-by: YoshiRulz <OSSYoshiRulz+GitHub@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Meta Relating to code organisation or to things that aren't code

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Quick question about your AI policy!

5 participants