added triage section to new contributor docs

story645 · timhoffm · rcomer · story645 · commit 35532f543bbd · 2024-08-08T14:17:25.000-04:00
Co-authored-by: Tim Hoffmann &lt;2836374+timhoffm@users.noreply.github.com&gt;
Co-authored-by: Ruth Comer &lt;10599679+rcomer@users.noreply.github.com&gt;
diff --git a/doc/devel/contribute.rst b/doc/devel/contribute.rst
@@ -158,6 +158,25 @@ 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
+------
+We appreciate help keeping our `issue tracker <https://github.com/matplotlib/matplotlib/issues>`_
+organized because the issue tracker is our centralized location for feature requests,
+bug reports, tracking major projects, and discussing priorities.
+
+Some examples of what we mean by triage are:
+
+* labeling issues and pull requests
+* verifying bug reports
+* debugging and resolving issues
+* linking to related issues, discussion, and external work
+
+Helping out with triage is discussed in detail in :ref:`bug_triaging`.
+
+If you have any questions about the process, please reach out on the
+:ref:`contributor_incubator`
 
 .. _other_ways_to_contribute:
 
diff --git a/doc/devel/index.rst b/doc/devel/index.rst
@@ -84,43 +84,63 @@ to contributing, we recommend that you first read our
    contribute
 
 .. grid:: 1 1 2 2
-   :class-row: sd-align-minor-center
+   :class-row: sd-fs-5 sd-align-minor-center
 
    .. grid-item::
-      :class: sd-fs-5
 
-      :octicon:`info;1em;sd-text-info` :ref:`Where should I start? <start-contributing>`
+      .. grid:: 1
+         :gutter: 1
+
+         .. grid-item::
+
+            :octicon:`info;1em;sd-text-info` :ref:`Where should I start? <start-contributing>`
+
+         .. grid-item::
+
+            :octicon:`question;1em;sd-text-info` :ref:`Where should I ask questions? <get_connected>`
 
-      :octicon:`question;1em;sd-text-info` :ref:`Where should I ask questions? <get_connected>`
+         .. grid-item::
 
-      :octicon:`git-pull-request;1em;sd-text-info` :ref:`How do I work on an issue? <managing_issues_prs>`
+            :octicon:`git-pull-request;1em;sd-text-info` :ref:`How do I work on an issue? <managing_issues_prs>`
 
-      :octicon:`codespaces;1em;sd-text-info` :ref:`How do I start a pull request? <how-to-pull-request>`
+         .. grid-item::
+
+            :octicon:`codespaces;1em;sd-text-info` :ref:`How do I start a pull request? <how-to-pull-request>`
 
    .. grid-item::
 
       .. grid:: 1
          :gutter: 1
-         :class-row: sd-fs-5
 
          .. grid-item-card::
             :link: contribute_code
             :link-type: ref
-            :shadow: none
+            :class-card: sd-outline-{primary} sd-shadow-none
+            :class-body: sd-text-{primary}
 
             :octicon:`code;1em;sd-text-info` Contribute code
 
          .. grid-item-card::
             :link: contribute_documentation
             :link-type: ref
-            :shadow: none
+            :class-card: sd-outline-{primary} sd-shadow-none
+            :class-body: sd-text-{primary}
 
             :octicon:`note;1em;sd-text-info` Write documentation
 
+         .. grid-item-card::
+            :link: contribute_triage
+            :link-type: ref
+            :class-card: sd-outline-{primary} sd-shadow-none
+            :class-body: sd-text-{primary}
+
+            :octicon:`issue-opened;1em;sd-text-info` Triage issues
+
          .. grid-item-card::
             :link: other_ways_to_contribute
             :link-type: ref
-            :shadow: none
+            :class-card: sd-outline-{primary} sd-shadow-none
+            :class-body: sd-text-{primary}
 
             :octicon:`globe;1em;sd-text-info` Build community
 
