You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: getting-started/generative-ai.rst
+8-8Lines changed: 8 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,10 +4,10 @@
4
4
Generative AI
5
5
=============
6
6
7
-
Generative AI has evolved rapidly over the past decade and will continue in the future.
8
-
Using generative AI and large language models (LLMs) can be helpful tools for contributors.
9
-
Their overuse can also be problematic, such as generation of incorrect code, inaccurate documentation, and unneeded code churn.
10
-
Discretion, good judgement, and critical thinking **must** be used when opening issues and pull requests.
7
+
Generative AI has evolved rapidly and can be impressive. As with using any tool, the resulting contribution is
8
+
the responsibility of the contributor. We value good code, concise accurate documentation, and avoiding unneeded code
9
+
churn. Discretion, good judgment, and critical thinking are the foundation of all good contributions, regardless of the
10
+
tools used in their creation.
11
11
12
12
Acceptable uses
13
13
===============
@@ -25,10 +25,10 @@ Maintainers may close issues and PRs that are not useful or productive, includin
25
25
those that are fully generated by AI. If a contributor repeatedly opens unproductive
26
26
issues or PRs, they may be blocked.
27
27
28
-
Anti-patterns
29
-
=============
30
-
- While AI-assisted tools such as autocompletion can enhance productivity, they sometimes rewrite entire code blocks instead of making small, focused edits.
28
+
Considerations or Keys for Success
29
+
==================================
30
+
- While AIassisted tools such as autocompletion can enhance productivity, they sometimes rewrite entire code blocks instead of making small, focused edits.
31
31
This can make it more difficult to review changes and to fully understand both the original intent of the code and the rationale behind the new modifications.
32
32
Maintaining consistency with the original code helps preserve clarity, traceability, and meaningful reviews and also helps us avoid unnecessary code churn.
33
33
- Sometimes AI assisted tools make failing unit tests pass by altering or bypassing the tests rather than addressing the underlying problem in the code.
34
-
Such changes do not represent a real fix and should be avoided.
34
+
Such changes do not represent a real fix. Authors must review the work done by AI tooling in detail to ensure it actually makes sense before proposing it as a PR.
0 commit comments