From de1dd423568539a330ab1d7c2a2552bab7ae4f93 Mon Sep 17 00:00:00 2001 From: Shlok Gilda Date: Sat, 31 Jan 2026 13:51:53 -0500 Subject: [PATCH 1/8] Add Generative AI disclosure policy to contribution guidelines and PR template Signed-off-by: Shlok Gilda --- .../PULL_REQUEST_TEMPLATE.md | 10 +++- CONTRIBUTING.md | 54 +++++++++++++++++++ 2 files changed, 63 insertions(+), 1 deletion(-) diff --git a/.github/PULL_REQUEST_TEMPLATE/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE/PULL_REQUEST_TEMPLATE.md index 864f4af875..2bad8bd2a1 100644 --- a/.github/PULL_REQUEST_TEMPLATE/PULL_REQUEST_TEMPLATE.md +++ b/.github/PULL_REQUEST_TEMPLATE/PULL_REQUEST_TEMPLATE.md @@ -10,4 +10,12 @@ about: Open a pull request. Please check your branch! Add any notes about why you made these changes, note-worthy technical details or caveats for your implementation, next steps, etc. Be as descriptive as you can. ## Related issues/PRs -- This is a bulleted list of any related issues/PRs; leave blank if there are none \ No newline at end of file +- This is a bulleted list of any related issues/PRs; leave blank if there are none + +### Generative AI Disclosure + + +- [ ] This contribution was assisted or created by Generative AI tools. + - Tools used: + - How were they used? + - What did you change after review? \ No newline at end of file diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 4df2a8dff2..d9e2b2895a 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -74,6 +74,60 @@ To ensure all your commits are signed, you may choose to [configure git](https:/ **Any pull requests containing commits that are not signed off will not be eligible for merge until the commits have been signed off.** +## Generative AI Policy + +You can use AI tools to help with your contributions. **You are the author, and you are accountable for the result.** + +### What we require + +1. **Disclose AI use.** Complete the AI disclosure section in the PR template. This is mandatory. If no AI was used, leave the checkbox unchecked — that's a valid answer. + +2. **Review before submitting.** Read and test all AI-generated code or text before asking maintainers to review it. If you can't explain why a change works, it's not ready for review. + +3. **Engage as yourself.** When maintainers give feedback, respond with your own understanding. Passing review comments into an LLM and pasting the output back doesn't help you learn and doesn't respect the reviewer's time. + +### Why we ask + +Reviewing contributions takes real time and energy. Submitting unreviewed AI output shifts that burden onto maintainers — this is sometimes called an "extractive contribution." + +Disclosure matters because: + +- **Respect.** Discovering a PR was unreviewed AI output after spending time on it feels like a waste. Telling us upfront lets us calibrate. +- **Research.** Augur measures open source community health. Understanding how AI tools are used in our own community is directly relevant to our mission. +- **Honesty.** Citing your tools is the same principle as citing Stack Overflow. It builds trust. + +### What counts + +This applies to all contributions: code, issues, PR comments, documentation. + +**Disclose:** code generation, test generation, documentation drafting, AI-assisted code review, substantial refactoring suggestions. + +**No need to disclose:** spell check, grammar correction, syntax highlighting, basic IDE autocomplete. + +### Quality standards + +AI-assisted contributions are held to the **same bar** as everything else. Good code is good code regardless of how it was written. Bad code gets rejected regardless of how it was written. + +For new contributors: **start small.** Submit changes you fully understand, get feedback, and build from there. Large AI-generated PRs that you can't fully explain are hard to review and unlikely to be merged. + +### Copyright + +You are responsible for ensuring you have the right to contribute code under our license. AI tools can reproduce copyrighted material, and using an AI to generate it doesn't remove the copyright. Contributions found to contain improperly licensed material will be removed. + +### Enforcement + +This policy is about transparency, not punishment. If you forget to check the box, just update your PR when asked. + +Patterns of submitting unreviewed AI output that repeatedly waste maintainer time may be addressed through the [CHAOSS Code of Conduct](https://chaoss.community/code-of-conduct/) process, the same as any other behavior that harms the community. + +### References + +- [ada-url AI Usage Policy](https://github.com/ada-url/ada/blob/main/AI_USAGE_POLICY.md) +- [Zulip AI Use Policy](https://github.com/zulip/zulip/blob/main/CONTRIBUTING.md#ai-use-policy-and-guidelines) +- [LLVM AI Tool Use Policy](https://discourse.llvm.org/t/rfc-llvm-ai-tool-policy-human-in-the-loop/89159) +- [Linux Foundation Generative AI Guidance](https://www.linuxfoundation.org/legal/generative-ai) +- [AI Attribution Spec](https://aiattribution.github.io/) + ## Keeping in sync with the Augur Repository Remember to sync your fork with the ```main``` branch regularly, by taking the following steps: From 5415be43d94818e15b1d538d889deb2f4183504d Mon Sep 17 00:00:00 2001 From: Shlok Gilda Date: Tue, 3 Feb 2026 11:08:18 -0500 Subject: [PATCH 2/8] Update CONTRIBUTING.md Co-authored-by: Adrian Edwards <17362949+MoralCode@users.noreply.github.com> Signed-off-by: Shlok Gilda --- CONTRIBUTING.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index d9e2b2895a..f761130525 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -82,7 +82,7 @@ You can use AI tools to help with your contributions. **You are the author, and 1. **Disclose AI use.** Complete the AI disclosure section in the PR template. This is mandatory. If no AI was used, leave the checkbox unchecked — that's a valid answer. -2. **Review before submitting.** Read and test all AI-generated code or text before asking maintainers to review it. If you can't explain why a change works, it's not ready for review. +2. **Review before submitting.** Read and test all AI-generated code or text before asking maintainers to review it. If you can't explain why a change works, it's not ready for a maintainer to review. If your changes are too long for you to read and review, that is a good indication that they are also too long for maintainers to read. 3. **Engage as yourself.** When maintainers give feedback, respond with your own understanding. Passing review comments into an LLM and pasting the output back doesn't help you learn and doesn't respect the reviewer's time. From beeb859a0160fa4d1fbdca41719dba2f74300fc5 Mon Sep 17 00:00:00 2001 From: Shlok Gilda Date: Tue, 3 Feb 2026 11:09:56 -0500 Subject: [PATCH 3/8] Update CONTRIBUTING.md Co-authored-by: Adrian Edwards <17362949+MoralCode@users.noreply.github.com> Signed-off-by: Shlok Gilda --- CONTRIBUTING.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index f761130525..f8981b5048 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -116,7 +116,7 @@ You are responsible for ensuring you have the right to contribute code under our ### Enforcement -This policy is about transparency, not punishment. If you forget to check the box, just update your PR when asked. +This policy is about transparency, not punishment. If you forget to check the box, just update your PR when asked. All contributions, whether AI-assisted or not, are expected to follow the same standards of quality before being merged. Patterns of submitting unreviewed AI output that repeatedly waste maintainer time may be addressed through the [CHAOSS Code of Conduct](https://chaoss.community/code-of-conduct/) process, the same as any other behavior that harms the community. From 28095928e5a57fce1eadfb4b92b24c02cc660336 Mon Sep 17 00:00:00 2001 From: Shlok Gilda Date: Tue, 3 Feb 2026 11:10:45 -0500 Subject: [PATCH 4/8] Update CONTRIBUTING.md Co-authored-by: Adrian Edwards <17362949+MoralCode@users.noreply.github.com> Signed-off-by: Shlok Gilda --- CONTRIBUTING.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index f8981b5048..3822483d71 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -118,7 +118,9 @@ You are responsible for ensuring you have the right to contribute code under our This policy is about transparency, not punishment. If you forget to check the box, just update your PR when asked. All contributions, whether AI-assisted or not, are expected to follow the same standards of quality before being merged. -Patterns of submitting unreviewed AI output that repeatedly waste maintainer time may be addressed through the [CHAOSS Code of Conduct](https://chaoss.community/code-of-conduct/) process, the same as any other behavior that harms the community. +Patterns of submitting low-quality contributions (such as large, unreviewed, or unfocused contributions made with or without AI) that repeatedly waste maintainer time may be addressed using the [CHAOSS Code of Conduct](https://chaoss.community/code-of-conduct/), which states: + +> Project maintainers are responsible for clarifying the standards of acceptable behavior and are expected to take appropriate and fair corrective action in response to any instances of unacceptable behavior. ### References From d92a260bd1605d8e6a2b84930b5f9388838ff7a1 Mon Sep 17 00:00:00 2001 From: Shlok Gilda Date: Tue, 3 Feb 2026 11:14:47 -0500 Subject: [PATCH 5/8] Update AI disclosure policy in PR template and contribution guidelines Signed-off-by: Shlok Gilda --- .../PULL_REQUEST_TEMPLATE/PULL_REQUEST_TEMPLATE.md | 6 ++++-- CONTRIBUTING.md | 14 +++----------- 2 files changed, 7 insertions(+), 13 deletions(-) diff --git a/.github/PULL_REQUEST_TEMPLATE/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE/PULL_REQUEST_TEMPLATE.md index 2bad8bd2a1..e299837e47 100644 --- a/.github/PULL_REQUEST_TEMPLATE/PULL_REQUEST_TEMPLATE.md +++ b/.github/PULL_REQUEST_TEMPLATE/PULL_REQUEST_TEMPLATE.md @@ -15,7 +15,9 @@ Add any notes about why you made these changes, note-worthy technical details or ### Generative AI Disclosure -- [ ] This contribution was assisted or created by Generative AI tools. +- [ ] No generative AI was used in this contribution. +- [ ] This contribution was assisted by generative AI tools. - Tools used: - How were they used? - - What did you change after review? \ No newline at end of file + - How did you review the AI output? + - What did you fix as a result? \ No newline at end of file diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 3822483d71..5bbe3c5753 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -76,11 +76,11 @@ To ensure all your commits are signed, you may choose to [configure git](https:/ ## Generative AI Policy -You can use AI tools to help with your contributions. **You are the author, and you are accountable for the result.** +You can use AI tools to help with your contributions, subject to the requirements below. **You are the author, and you are accountable for the result.** ### What we require -1. **Disclose AI use.** Complete the AI disclosure section in the PR template. This is mandatory. If no AI was used, leave the checkbox unchecked — that's a valid answer. +1. **Disclose AI use.** Complete the AI disclosure section in the PR template. This is mandatory. If no AI was used, check the "No generative AI" box — that's a valid answer, and it helps us distinguish from incomplete templates. 2. **Review before submitting.** Read and test all AI-generated code or text before asking maintainers to review it. If you can't explain why a change works, it's not ready for a maintainer to review. If your changes are too long for you to read and review, that is a good indication that they are also too long for maintainers to read. @@ -102,7 +102,7 @@ This applies to all contributions: code, issues, PR comments, documentation. **Disclose:** code generation, test generation, documentation drafting, AI-assisted code review, substantial refactoring suggestions. -**No need to disclose:** spell check, grammar correction, syntax highlighting, basic IDE autocomplete. +This policy covers generative AI tools specifically. Non-generative tools like spell check, grammar correction, syntax highlighting, and basic IDE autocomplete are not in scope. ### Quality standards @@ -122,14 +122,6 @@ Patterns of submitting low-quality contributions (such as large, unreviewed, or > Project maintainers are responsible for clarifying the standards of acceptable behavior and are expected to take appropriate and fair corrective action in response to any instances of unacceptable behavior. -### References - -- [ada-url AI Usage Policy](https://github.com/ada-url/ada/blob/main/AI_USAGE_POLICY.md) -- [Zulip AI Use Policy](https://github.com/zulip/zulip/blob/main/CONTRIBUTING.md#ai-use-policy-and-guidelines) -- [LLVM AI Tool Use Policy](https://discourse.llvm.org/t/rfc-llvm-ai-tool-policy-human-in-the-loop/89159) -- [Linux Foundation Generative AI Guidance](https://www.linuxfoundation.org/legal/generative-ai) -- [AI Attribution Spec](https://aiattribution.github.io/) - ## Keeping in sync with the Augur Repository Remember to sync your fork with the ```main``` branch regularly, by taking the following steps: From 7de16ca1d6f7d992ce31a7411e3e265613d9b78e Mon Sep 17 00:00:00 2001 From: Shlok Gilda Date: Sun, 15 Feb 2026 13:10:22 -0500 Subject: [PATCH 6/8] Add AI disclosure to default PR template and remove unused template Consolidates the AI disclosure section into the actual default PR template (pull_request_template.md) and removes the unused PULL_REQUEST_TEMPLATE/ directory that wasn't auto-populating. Signed-off-by: Shlok Gilda --- .../PULL_REQUEST_TEMPLATE.md | 23 ------------------- .github/pull_request_template.md | 14 +++++++++-- 2 files changed, 12 insertions(+), 25 deletions(-) delete mode 100644 .github/PULL_REQUEST_TEMPLATE/PULL_REQUEST_TEMPLATE.md diff --git a/.github/PULL_REQUEST_TEMPLATE/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE/PULL_REQUEST_TEMPLATE.md deleted file mode 100644 index e299837e47..0000000000 --- a/.github/PULL_REQUEST_TEMPLATE/PULL_REQUEST_TEMPLATE.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -name: Pull Request -about: Open a pull request. Please check your branch! - ---- -## Changeset -- This is a bulleted list of the changes you are suggesting. These should be high-level; think commit message - -## Notes -Add any notes about why you made these changes, note-worthy technical details or caveats for your implementation, next steps, etc. Be as descriptive as you can. - -## Related issues/PRs -- This is a bulleted list of any related issues/PRs; leave blank if there are none - -### Generative AI Disclosure - - -- [ ] No generative AI was used in this contribution. -- [ ] This contribution was assisted by generative AI tools. - - Tools used: - - How were they used? - - How did you review the AI output? - - What did you fix as a result? \ No newline at end of file diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md index 2969abeae2..8f48590651 100644 --- a/.github/pull_request_template.md +++ b/.github/pull_request_template.md @@ -8,12 +8,22 @@ This PR fixes # **Signed commits** - [ ] Yes, I signed my commits. +**Generative AI Disclosure** + + +- [ ] No generative AI was used in this contribution. +- [ ] This contribution was assisted by generative AI tools. + - Tools used: + - How were they used? + - How did you review the AI output? + - What did you fix as a result? + - How were they used? - - How did you review the AI output? - - What did you fix as a result? + - How did you review the AI output? + - What did you fix or change?