explain that gfi is for training, add no AI policy,

story645 · timhoffm · story645 · commit de439a3f40c8 · 2026-02-16T17:28:13.000-05:00
move difficulty under issues
[ci doc]

Co-authored-by: Tim Hoffmann &lt;2836374+timhoffm@users.noreply.github.com&gt;
diff --git a/.github/workflows/good-first-issue.yml b/.github/workflows/good-first-issue.yml
@@ -19,7 +19,7 @@ jobs:
             ### Good first issue - notes for new contributors
 
             This issue is suited to new contributors because it does not require
-            understanding of the Matplotlib internals. This is a low priority task
+            understanding of the Matplotlib internals. This is a not urgent task
             intended for human contributors to learn how to contribute; therefore please
             do not try to automate a solution using AI. To get started, please see our
             [contributing guide](https://matplotlib.org/stable/devel/index).
diff --git a/doc/devel/contribute.rst b/doc/devel/contribute.rst
@@ -203,10 +203,6 @@ result is not of value to the project. To preserve precious core developer
 capacity, we reserve the right to rigorously reject seemingly AI generated
 low-value contributions.
 
-In particular, it is also strictly forbidden to post AI generated
-content to issues or PRs via automated tooling such as bots or agents. We
-may ban such users and/or report them to GitHub.
-
 .. _new_contributors:
 
 New contributors
@@ -260,23 +256,14 @@ To join, please go to our public `community gitter`_ channel, and ask to be adde
 Good first issues
 -----------------
 
-While any contributions are welcome, we have marked some issues as
-particularly suited for new contributors by the label `good first issue
-<https://github.com/matplotlib/matplotlib/labels/good%20first%20issue>`_. These
-are well documented issues, that do not require a deep understanding of the
-internals of Matplotlib. The issues may additionally be tagged with a
-difficulty. ``Difficulty: Easy`` is suited for people with little Python
-experience. ``Difficulty: Medium`` and ``Difficulty: Hard`` require more
-programming experience. This could be for a variety of reasons, among them,
-though not necessarily all at the same time:
-
-- The issue is in areas of the code base which have more interdependencies,
-  or legacy code.
-- It has less clearly defined tasks, which require some independent
-  exploration, making suggestions, or follow-up discussions to clarify a good
-  path to resolve the issue.
-- It involves Python features such as decorators and context managers, which
-  have subtleties due to our implementation decisions.
+We have marked some issues as `good first issue
+<https://github.com/matplotlib/matplotlib/labels/good%20first%20issue>`_ because we
+think they are a good entry point into the process of contributing to Matplotlib. These
+issues are well documented, do not require a deep understanding of the internals of
+Matplotlib, and do not need urgent resolution. Pull requests that are :ref:`AI generated <generative_ai>`
+will be closed because good first issues are intended to onboard newcomers with a
+genuine interest in improving Matplotlib in the hopes they will continue to participate
+in our development community.
 
 .. _first_contribution:
 
@@ -334,6 +321,21 @@ a new PR; duplicate PRs are subject to being closed.  However, if the existing
 PR is an outline, unlikely to work, or stalled, and the original author is
 unresponsive, feel free to open a new PR referencing the old one.
 
+Difficulty
+----------
+Issues may additionally be tagged with a difficulty. ``Difficulty: Easy`` is suited
+for people with little Python experience. ``Difficulty: Medium`` and
+``Difficulty: Hard`` require more programming experience. This could be for a variety of
+reasons, among them, e.g.:
+
+- requires understanding intermediate to advanced Python features, such as decorators,
+  context managers, or meta-programming
+- is in areas of the code base which have more interdependencies or is legacy code.
+- involves complex or significant changes to algorithms or architecture.
+
+Generally, the difficulty level is correlated with how much conceptual (and contextual)
+understanding of Matplotlib is required to resolve it.
+
 .. _how-to-pull-request:
 
 Start a pull request
