1- .. _ generative-ai :
1+ .. _ ai-tools :
22
33=================================
4- Guidelines in using Generative AI
4+ Guidelines for using AI tools
55=================================
66
7- Generative AI tools are evolving rapidly, and their work can be helpful . As with using any tool, the resulting
7+ Generative AI tools can produce output quickly . As with using any tool, the resulting
88contribution is the responsibility of the contributor. We value good code, concise accurate documentation,
9- and avoiding unneeded code churn. Discretion, good judgment, and critical thinking are the foundation of all good
9+ and well scoped PRs without unneeded code churn. Discretion, good judgment, and critical thinking are the foundation of all good
1010contributions, regardless of the tools used in their creation.
1111
1212Considerations for success
1313==========================
1414
15- Authors must review the work done by AI tooling in detail to ensure it actually makes sense before proposing it as a PR.
15+ Authors must review the work done by AI tooling in detail to ensure it actually makes sense before proposing it as a PR or filing it as an issue .
1616
17- We expect PR authors to be able to explain their proposed changes in their own words.
17+ We expect PR authors and those filing issues to be able to explain their proposed changes in their own words.
1818
1919Disclosure of the use of AI tools in the PR description is appreciated, while not required. Be prepared to explain how
2020the tool was used and what changes it made.
2121
22- Whether you are using Generative AI or not, keep the following principles in mind for the quality
22+ Whether you are using AI tools or not, keep the following principles in mind for the quality
2323of your contribution:
2424
2525- Consider whether the change is necessary
@@ -40,7 +40,7 @@ Unacceptable uses
4040=================
4141
4242Maintainers may close issues and PRs that are not useful or productive, regardless of whether
43- AI was used or not.
43+ AI tools were used or not.
4444
4545If a contributor repeatedly opens unproductive issues or PRs, they may be blocked.
4646
0 commit comments