doc: add AI guidelines

Add AI guidelines based on discussions from the most recent community
meeting.

Signed-off-by: Blaine Gardner <blaine.gardner@ibm.com>
(cherry picked from commit ebf4656481)
This commit is contained in:
Blaine Gardner authored and Mergify committed 2026-06-02 17:48:33 +00:00
1 parent 7c7e433400
commit 3ff1f06353
5 files changed
+39

No files matched your search

+1
View File
@@ -16,6 +16,7 @@ Resolves #
- [ ] **Commit Message Formatting**: Commit titles and messages follow guidelines in the [developer guide](https://rook.io/docs/rook/latest/Contributing/development-flow/#commit-structure).
- [ ] Reviewed the developer guide on [Submitting a Pull Request](https://rook.io/docs/rook/latest/Contributing/development-flow/#submitting-a-pull-request)
- [ ] Reviewed [AI guidelines](https://rook.io/docs/rook/latest/Contributing/ai-guidelines), if AI assisted with the PR.
- [ ] [Pending release notes](https://github.com/rook/rook/blob/master/PendingReleaseNotes.md) updated with breaking and/or notable changes for the next minor release.
- Overwriting Ceph's configurations should be marked as breaking changes.
- [ ] Documentation has been updated, if necessary.
+4
View File
@@ -106,6 +106,10 @@ second line is always blank, and other lines should be wrapped at 80 characters.
This allows the message to be easier to read on GitHub as well as in various
git tools.
## AI Guidelines
Review Rook's [AI Guidelines](https://rook.io/docs/rook/latest/Contributing/ai-guidelines)
## Change Approval
The Rook project aims to empower contributors to approve and merge code changes autonomously.
+1
View File
@@ -1,5 +1,6 @@
nav:
- development-flow.md
- ai-guidelines.md
- development-environment.md
- documentation.md
- ...
@@ -0,0 +1,27 @@
---
title: AI Guidelines
---
Rook's AI guidelines are focused on preserving trust. Thousands of Rook users trust Rook and its maintainers to release enterprise-grade software with as few issues as possible and with as much transparency as possible. Each person who contributes code to Rook must be able to do so in a way that preserves maintainer trust, and by extension, user trust.
## Legal requirements
As a CNCF project, Rook follows the [Linux Foundation Guidelines](https://www.linuxfoundation.org/legal/generative-ai) for ensuring legal compliance. These guidelines require contributors to check (in summary):
1. AI tool restrictions: Contributors must ensure the AI tool's terms don't impose contractual limitations that conflict with the project's license.
2. Third-party content permissions: If generated output contains copyrighted materials from others, contributors must confirm proper permissions exist (via compatible license) and provide license information when contributing.
In order to ensure legal guidelines, Rook requires human involvement and engagement and does not allow fully-autonomous or near-fully-autonomous "bots" to submit issues or pull requests. If Rook maintainers have reasonable cause to believe a contribution does not have human oversight, it will be rejected.
## Transparency requirements
1. Contributors should disclose in pull request descriptions how AI tools assisted in development. E.g., generating substantial functions, documentation, and/or unit tests.
2. Rook requires human sign-off. Signing commits using an AI tool, or listing AI tooling in commits using `co-authored-by`, `assisted-by`, `generated-by`, or using similar commit trailers is not necessary.
## Best practices to respect maintainer time
AI models are making it much easier to contribute code to open source, and maintainer time is limited.
1. Consider opening an issue following [issue guidelines](development-flow.md#begin-with-an-issue) before contributing.
2. Do not submit large AI-generated PRs without previous design discussion. Follow [Kubernetes's guidelines for large/automatic edits](https://www.kubernetes.dev/docs/guide/pull-requests/#large-or-automatic-edits) as needed.
3. Do not use LLM output to write commit messages or GitHub comments. Reviewers are interested in knowing your reasoning about the code you submitted for review. It's yours to own and explain. Automated responses may result in a PR being rejected.
@@ -136,6 +136,12 @@ rook
To submit a change, create a branch in your fork and then submit a pull request (PR) from the branch.
### Begin with an Issue
Before working on code changes requiring more than a simple bug fix, maintainers recommend creating a GitHub issue, including filling in the issue template.
Discuss options for appropriate issue resolution with maintainers, and get confirmation before creating a pull request.
This can help avoid unnecessary work needed when the design approach needs substantially changed before a contribution can be merged.
### Design Document
For new features of significant scope and complexity, a design document is recommended before work begins on the implementation.