1
0
mirror of https://github.com/robbyrussell/oh-my-zsh.git synced 2026-01-17 07:53:09 +01:00

2 Commits

Author SHA1 Message Date
Robby Russell
6afcbc0ad5 docs: add AI disclosure checkbox to PR template
Add checkbox to encourage contributors to disclose AI tool usage
(ChatGPT, Claude, Gemini, etc.) in their pull requests, complementing
the new AI usage policy in CONTRIBUTING.md.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-16 11:53:14 -08:00
Robby Russell
35401d8fb9 docs: add AI usage policy to CONTRIBUTING.md
Add guidance for contributors using AI tools in their submissions, including:
- Disclosure requirements for meaningful AI assistance
- Examples of good disclosure (ChatGPT, Claude, Gemini)
- Expectations for code understanding and quality
- Clear communication about maintainer time and review process

Inspired by Ghostty's approach to AI disclosure in contributions:
https://github.com/ghostty-org/ghostty/blob/main/CONTRIBUTING.md

Collaborated with Claude to draft this policy, comparing approaches
and refining the language to match Oh My Zsh's community voice.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-16 11:47:20 -08:00
2 changed files with 26 additions and 0 deletions

View File

@@ -7,6 +7,7 @@
- [ ] I have read the contribution guide and followed all the instructions.
- [ ] The code follows the code style guide detailed in the wiki.
- [ ] The code is mine or it's from somewhere with an MIT-compatible license.
- [ ] If I used AI tools (ChatGPT, Claude, Gemini, etc.) to assist with this contribution, I've disclosed it below.
- [ ] The code is efficient, to the best of my ability, and does not waste computer resources.
- [ ] The code is stable and I have tested it myself, to the best of my abilities.
- [ ] If the code introduces new aliases, I provide a valid use case for all plugin users down below.

View File

@@ -20,6 +20,7 @@ you would make is not already covered.
- [Getting started](#getting-started)
- [You have a solution](#you-have-a-solution)
- [You have an addition](#you-have-an-addition)
- [A note on AI-assisted contributions](#a-note-on-ai-assisted-contributions)
- [Use the Search, Luke](#use-the-search-luke)
- [Commit Guidelines](#commit-guidelines)
- [Format](#format)
@@ -125,6 +126,30 @@ Because of this, from now on, we require that new aliases follow these condition
This list is not exhaustive! Please remember that your alias will be in the machines of many people,
so it should be justified why they should have it.
## A note on AI-assisted contributions
We'll admit it: AI tools can be pretty helpful for coding tasks, and we're not here to gatekeep how you get your work done. We use these tools ourselves! 🤖
But here's the thing—Oh My Zsh is maintained by a small team of volunteers who do this in their spare time. We already have hundreds of pending PRs, and we want to make sure we're spending our limited time effectively.
If you used AI tools meaningfully in your contribution (code generation, agentic coding assistants, etc.), please mention it in your PR description. Basic autocomplete doesn't count, but if an AI wrote substantial parts of your code, just let us know.
**Examples of good disclosure:**
- "Used ChatGPT to help generate the initial regex pattern for parsing git status output"
- "Claude assisted with writing the unit tests for this feature"
- "Generated with Gemini and then reviewed/tested manually"
- Or simply: "AI-assisted" in your PR description
Here's what we're looking for:
- **You understand your code**: You should be able to explain what your contribution does and how it works. We want to collaborate with humans who are invested in the project.
- **Context matters**: Tell us what problem you're solving, how you tested it, and link to relevant docs. Small, incremental changes work better than massive generated overhauls.
- **Quality over quantity**: We'd rather have one thoughtful, well-tested contribution than ten AI-generated PRs that need extensive review.
The disclosure helps us know how much guidance to offer. If we're just reviewing AI output that you can't explain or improve, that changes the dynamic—and frankly, it's not a great use of anyone's time.
As always, we reserve the right to decline any contribution. PRs that appear to be unreviewed AI output, or code the contributor can't explain, may be closed without extensive feedback.
----
## Use the Search, Luke