Add a brief page on Generative AI usage (python#1451)

willingc · hugovk · JelleZijlstra · web-flow · commit 1ffa42a43a2a · 2024-10-22T00:10:37.000-07:00
* Add a brief page on Generative AI usage

* Apply suggestions from code review from Jelle and Hugo

Co-authored-by: Hugo van Kemenade &lt;1324225+hugovk@users.noreply.github.com&gt;
Co-authored-by: Jelle Zijlstra &lt;jelle.zijlstra@gmail.com&gt;

* Add suggested wording from jelle

---------

Co-authored-by: Hugo van Kemenade &lt;1324225+hugovk@users.noreply.github.com&gt;
Co-authored-by: Jelle Zijlstra &lt;jelle.zijlstra@gmail.com&gt;
diff --git a/getting-started/generative-ai.rst b/getting-started/generative-ai.rst
@@ -0,0 +1,26 @@
+.. _generative-ai:
+
+=============
+Generative AI
+=============
+
+Generative AI has evolved rapidly over the past decade and will continue in the future.
+Using generative AI and large language models (LLMs) can be helpful tools for contributors.
+Their overuse can also be problematic, such as generation of incorrect code, inaccurate documentation, and unneeded code churn.
+Discretion, good judgement, and critical thinking **must** be used when opening issues and pull requests.
+
+Acceptable uses
+===============
+
+Some of the acceptable uses of generative AI include:
+
+- Assistance with writing comments, especially in a non-native language
+- Gaining understanding of existing code
+- Supplementing contributor knowledge for code, tests, and documentation
+
+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.
diff --git a/getting-started/index.rst b/getting-started/index.rst
@@ -12,3 +12,4 @@ Getting started
    git-boot-camp
    pull-request-lifecycle
    getting-help
+   generative-ai
