Skip to content

Commit af9d523

Browse files
committed
add a policy on AI usage
1 parent a64a237 commit af9d523

File tree

1 file changed

+13
-3
lines changed

1 file changed

+13
-3
lines changed

contributors/guide/pull-requests.md

Lines changed: 13 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -37,6 +37,7 @@ It should serve as a reference for all contributors, and be useful especially to
3737
- [Trivial Edits](#trivial-edits)
3838
- [Large or Automatic Edits](#large-or-automatic-edits)
3939
- [Fixing Linter Issues](#fixing-linter-issues)
40+
- [AI Guidance](#ai-guidance)
4041
- [The Testing and Merge Workflow](#the-testing-and-merge-workflow)
4142
- [More About `Ok-To-Test`](#more-about-ok-to-test)
4243

@@ -599,16 +600,16 @@ at once to that file.
599600

600601
## Large or Automatic Edits
601602

602-
Some tools make it very easy to create large Pull Requests, for example:
603+
Some tools make it very easy to create large and/or automatic Pull Requests, for example:
603604
- global search/replace
604605
- linters which automatically correct issues (see also next section)
605-
- large language models (LLMs) which generate code or documentation
606+
- AI tools (large language models, assistants, etc) which generate code or documentation
606607

607608
To make it easier for reviewers to handle such Pull Requests, please explain
608609
how it was generated in the "Special notes for your reviewer" section of the
609610
Pull Request description. Reviewers may then be able to reproduce those steps
610611
(search/replace, linters) or can start the review with the right expectations
611-
(LLMs). Also consider the section about [splitting up Pull
612+
(AI tools). Also consider the section about [splitting up Pull
612613
Requests](#dont-open-pull-requests-that-span-the-whole-repository) above.
613614

614615
Even with such tools it is still your responsibility as submitter of a Pull
@@ -622,6 +623,15 @@ reference to this documentation if they come to the conclusion that the
622623
difficulty of properly reviewing the Pull Request outweighs the benefit that
623624
the Pull Request provides.
624625

626+
## AI Guidance
627+
628+
Using AI tools to help write your PR is acceptable, but as the author, you are responsible for understanding every change.
629+
Reviewers may ask questions about your AI-assisted code, and if you cannot explain why a change was made, the PR will be closed.
630+
When responding to review comments, please do so without relying on AI tools. Reviewers want to engage directly with you, not with generated responses.
631+
If you used AI tools in preparing your PR, please disclose this in the "Special notes for your reviewer" section.
632+
All contributions must follow the [contributions policies](/contributors/guide/contributing.md) and use commit messages that align with [the policy](#commit-message-guidelines).
633+
[Large AI generated](#large-or-automatic-edits) PRs and AI generated commit messages are discouraged.
634+
625635
## Fixing Linter Issues
626636

627637
Kubernetes has a set of linter checks. Some of those must pass in the entire

0 commit comments

Comments
 (0)