From 55e0a9e3b38f83260d3ba206ee4f81119d20bdf3 Mon Sep 17 00:00:00 2001 From: Donghee Na Date: Sat, 1 Nov 2025 18:04:59 +0900 Subject: [PATCH 1/5] generative-ai: Add anti pattern example --- getting-started/generative-ai.rst | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/getting-started/generative-ai.rst b/getting-started/generative-ai.rst index 90fe020f3..e6d35c591 100644 --- a/getting-started/generative-ai.rst +++ b/getting-started/generative-ai.rst @@ -24,3 +24,10 @@ Unacceptable uses Maintainers may close issues and PRs that are not useful or productive, including those that are fully generated by AI. If a contributor repeatedly opens unproductive issues or PRs, they may be blocked. + +Anti-patterns +============= +- While AI-assisted tools such as autocompletion can enhance productivity, they sometimes rewrite entire code blocks instead of making small, focused edits. + 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. + Please keep maintaining consistency with the original code helps preserve clarity, traceability, and meaningful review. + From 2a102b844631625985992503044f31b9a76eb9d9 Mon Sep 17 00:00:00 2001 From: Donghee Na Date: Sat, 1 Nov 2025 18:51:19 +0900 Subject: [PATCH 2/5] reformat --- getting-started/generative-ai.rst | 1 - 1 file changed, 1 deletion(-) diff --git a/getting-started/generative-ai.rst b/getting-started/generative-ai.rst index e6d35c591..02dad6d06 100644 --- a/getting-started/generative-ai.rst +++ b/getting-started/generative-ai.rst @@ -30,4 +30,3 @@ Anti-patterns - While AI-assisted tools such as autocompletion can enhance productivity, they sometimes rewrite entire code blocks instead of making small, focused edits. 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. Please keep maintaining consistency with the original code helps preserve clarity, traceability, and meaningful review. - From 7a7bec220fa256c734f266a52186905d8b69328f Mon Sep 17 00:00:00 2001 From: Donghee Na Date: Sat, 1 Nov 2025 20:05:25 +0900 Subject: [PATCH 3/5] Address code review --- getting-started/generative-ai.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/getting-started/generative-ai.rst b/getting-started/generative-ai.rst index 02dad6d06..f15bdcc7d 100644 --- a/getting-started/generative-ai.rst +++ b/getting-started/generative-ai.rst @@ -29,4 +29,4 @@ Anti-patterns ============= - While AI-assisted tools such as autocompletion can enhance productivity, they sometimes rewrite entire code blocks instead of making small, focused edits. 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. - Please keep maintaining consistency with the original code helps preserve clarity, traceability, and meaningful review. + Maintaining consistency with the original code helps preserve clarity, traceability, and meaningful reviews and also helps us avoid unnecessary code churn. From f0e60d096a1ce35f1449fc1b73932eb7e654b287 Mon Sep 17 00:00:00 2001 From: Donghee Na Date: Sat, 1 Nov 2025 20:09:03 +0900 Subject: [PATCH 4/5] Add one more case --- getting-started/generative-ai.rst | 2 ++ 1 file changed, 2 insertions(+) diff --git a/getting-started/generative-ai.rst b/getting-started/generative-ai.rst index f15bdcc7d..6c88fd7db 100644 --- a/getting-started/generative-ai.rst +++ b/getting-started/generative-ai.rst @@ -30,3 +30,5 @@ Anti-patterns - While AI-assisted tools such as autocompletion can enhance productivity, they sometimes rewrite entire code blocks instead of making small, focused edits. 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. Maintaining consistency with the original code helps preserve clarity, traceability, and meaningful reviews and also helps us avoid unnecessary code churn. +- Sometimes AI assisted tools make failing unit tests pass by altering or bypassing the tests rather than addressing the underlying problem in the code. + Such changes do not represent a real fix and should be avoided. From 131f62fdeee10cf092443c0623c5e658f0251f55 Mon Sep 17 00:00:00 2001 From: Donghee Na Date: Sat, 1 Nov 2025 20:20:13 +0900 Subject: [PATCH 5/5] reformat --- getting-started/generative-ai.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/getting-started/generative-ai.rst b/getting-started/generative-ai.rst index 6c88fd7db..7a83fbc7a 100644 --- a/getting-started/generative-ai.rst +++ b/getting-started/generative-ai.rst @@ -30,5 +30,5 @@ Anti-patterns - While AI-assisted tools such as autocompletion can enhance productivity, they sometimes rewrite entire code blocks instead of making small, focused edits. 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. Maintaining consistency with the original code helps preserve clarity, traceability, and meaningful reviews and also helps us avoid unnecessary code churn. -- Sometimes AI assisted tools make failing unit tests pass by altering or bypassing the tests rather than addressing the underlying problem in the code. +- Sometimes AI assisted tools make failing unit tests pass by altering or bypassing the tests rather than addressing the underlying problem in the code. Such changes do not represent a real fix and should be avoided.