added triage section to new contributor docs

story645 · story645 · commit 358d37f3cadb · 2024-06-04T22:00:44.000-04:00
diff --git a/doc/devel/contribute.rst b/doc/devel/contribute.rst
@@ -161,6 +161,30 @@ please reach out on the :ref:`contributor_incubator`
 
 .. _`open an issue`: https://github.com/matplotlib/matplotlib/issues/new?assignees=&labels=Documentation&projects=&template=documentation.yml&title=%5BDoc%5D%3A+
 
+.. _contribute_triage:
+
+Triage
+------
+The `issue tracker <https://github.com/matplotlib/matplotlib/issues>`_ is our
+centralized location for feature requests, bug reports,
+tracking major projects and discussing priorities. It takes a lot of
+time and effort to keep oragnized, so curating our issue tracker is a valuable
+contribution. Some examples are:
+
+* improving and verifying bug reports and feature requests
+* linking to related issues, discussion, and external work
+* labeling issues and pull requests
+* helping to solve issues with high quality verified solutions
+
+Helping out with triage is discussed in detail in :ref:`bug_triaging`.
+
+Triage help is a valuable contribution because it takes a lot of time and
+judgement to effectively curate and resolve issues; therefore we very much
+appreciate thoughtful feedback to issue authors. Please do not verbatim post
+the output of a generative AI tool (such as chat GPT) as a response to a bug
+report as we expect that the issue author has either already tried that or has a
+reason for not doing so.
+
 
 .. _other_ways_to_contribute:
 
diff --git a/doc/devel/index.rst b/doc/devel/index.rst
@@ -108,6 +108,13 @@ New contributors
 
             :octicon:`note;1em;sd-text-info` Write documentation
 
+         .. grid-item-card::
+            :link: contribute_triage
+            :link-type: ref
+            :shadow: none
+
+            :octicon:`note;1em;sd-text-info` Help triage
+
          .. grid-item-card::
             :link: other_ways_to_contribute
             :link-type: ref
