added a top level setup link + reshuffling into one open issue block

story645 · story645 · commit 6b5c3179f9dc · 2023-06-07T15:17:55.000-04:00
diff --git a/doc/devel/contributing.rst b/doc/devel/contributing.rst
@@ -156,15 +156,25 @@ 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.
 
+
+.. _open-an-issue:
+
+Open an issue
+=============
+
+Please tell us about bugs in the code and documentation, optimizations and
+improvements that we can make, and new features that would be nice to have by
+opening an issue on our
+`Issue Tracker <https://github.com/matplotlib/matplotlib/issues>`_.
+
+If you would like to help us process issues, please see our
+:ref:`triage guide<bug_triaging>`.
+
+
 .. _submitting-a-bug-report:
 
 Submitting a bug report
-=======================
-
-If you find a bug in the code or documentation, do not hesitate to submit a
-ticket to the
-`Issue Tracker <https://github.com/matplotlib/matplotlib/issues>`_. You are
-also welcome to post feature requests or pull requests.
+-----------------------
 
 If you are reporting a bug, please do your best to include the following:
 
@@ -197,16 +207,20 @@ Thank you for your help in keeping bug reports complete, targeted and descriptiv
 .. _request-a-new-feature:
 
 Requesting a new feature
-========================
+------------------------
 
-Please post feature requests to the
-`Issue Tracker <https://github.com/matplotlib/matplotlib/issues>`_.
+If you are requesting that we implement a feature, please do your best to
+include a summary of the problem this feature solves and possible approaches for
+implementing the request. When possible, please include any related work, such
+as academic papers on the feature and links to how other libraries implement of
+the feature.
 
 The Matplotlib developers will give feedback on the feature proposal. Since
 Matplotlib is an open source project with limited resources, we encourage
 users to then also
 :ref:`participate in the implementation <contributing-code>`.
 
+
 .. _contributing-code:
 
 Contributing code
diff --git a/doc/devel/index.rst b/doc/devel/index.rst
@@ -21,35 +21,36 @@ process or how to fix something feel free to ask on `gitter
 
 .. rst-class:: sd-d-inline-block
 
-    .. button-ref:: submitting-a-bug-report
+    .. button-ref:: open-an-issue
         :class: sd-fs-6
         :color: primary
 
-        Report a bug
+        Open an issue
 
 .. rst-class:: sd-d-inline-block
 
-    .. button-ref:: request-a-new-feature
+    .. button-ref:: contributing-code
         :class: sd-fs-6
         :color: primary
 
-        Request a feature
+        Contribute code
 
 .. rst-class:: sd-d-inline-block
 
-    .. button-ref:: contributing-code
+    .. button-ref:: documenting-matplotlib
         :class: sd-fs-6
         :color: primary
 
-        Contribute code
+        Write documentation
 
 .. rst-class:: sd-d-inline-block
 
-    .. button-ref:: documenting-matplotlib
+    .. button-ref:: development-setup
         :class: sd-fs-6
         :color: primary
 
-        Write documentation
+        Setup environment
+
 
 .. toctree::
    :maxdepth: 2
@@ -66,6 +67,10 @@ process or how to fix something feel free to ask on `gitter
    dependencies.rst
    min_dep_policy.rst
    maintainer_workflow.rst
+
+.. toctree::
+   :maxdepth: 1
+
    MEP/index
 
 .. toctree::
