diff --git a/AI_POLICY.md b/AI_POLICY.md new file mode 100644 index 0000000000..5aaa6977a5 --- /dev/null +++ b/AI_POLICY.md @@ -0,0 +1,34 @@ +# AI Contribution Policy + +This project **welcomes the thoughtful use of AI tools** when contributing, yet asks all contributors to follow two core principles. + +## Never let an LLM speak for you + +When maintainers read a comment, an issue, or a pull request from you, they want to know they are hearing your words. Grammar and spelling do not matter. What matters is real connection. + +- All comments, issues, and pull request descriptions should be written in your own voice +- We value clear, human communication over perfect grammar or spelling +- Avoid copy-pasting AI-generated summaries that don't reflect your own understanding + +AI-generated summaries tend to be long-winded, dense, and often inaccurate. Simplicity is an art. The goal is not to sound impressive, but to communicate clearly. + +## Never let an LLM think for you + +Go ahead and use AI to explore the codebase, or to write the function or test you need. But the final step before contributing should always be understanding what it has written. + +- Feel free to use AI tools to generate code or explore ideas +- Only submit contributions you fully understand and can explain +- Contributions should reflect your own reasoning and problem-solving + +Use AI to point you in the right direction, but always take personal responsibility. Do not quote an LLM in an issue or pull request. Maintainers want to know what you think. + +Our aim is ensuring quality and maintaining the joy of collaborating and communicating with real people. + +## Summary + +- AI may be used to generate code or explore ideas +- Comments, issues, and pull request descriptions must be written in your own voice +- Contributions must be fully understood and explainable by the contributor +- Contribution guidelines must still be followed + +Read more about this and other AI contribution policies on [ai-policy.dev](https://ai-policy.dev/) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 9eb942b099..6f60c45b03 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1249,15 +1249,7 @@ The configuration for the pre-commit hook is defined in the [`staged` block of v ## Using AI -You're welcome to use AI tools to help you contribute. But there are two important ground rules: - -### 1. Never let an LLM speak for you - -When you write a comment, issue, or PR description, use your own words. Grammar and spelling don't matter – real connection does. AI-generated summaries tend to be long-winded, dense, and often inaccurate. Simplicity is an art. The goal is not to sound impressive, but to communicate clearly. - -### 2. Never let an LLM think for you - -Feel free to use AI to write code, tests, or point you in the right direction. But always understand what it's written before contributing it. Take personal responsibility for your contributions. Don't say "ChatGPT says..." – tell us what _you_ think. +Please read our full [AI Contribution Policy](./AI_POLICY.md) before contributing. For more context, see [Using AI in open source](https://roe.dev/blog/using-ai-in-open-source).