reorg into cards and grids

story645 · story645 · commit 254ce22aafbe · 2023-06-20T14:26:03.000-04:00
diff --git a/doc/devel/contributing.rst b/doc/devel/contributing.rst
@@ -75,6 +75,8 @@ There are a few typical new contributor profiles:
   and gaining context on this area by reading the issues and pull requests
   touching these subjects is a reasonable approach.
 
+.. _get_connected:
+
 Get Connected
 =============
 
@@ -143,6 +145,8 @@ though not necessarily all at the same time:
 - It involves Python features such as decorators and context managers, which
   have subtleties due to our implementation decisions.
 
+.. _managing_issues_prs:
+
 Assigning issues and duplicating pull requests
 ----------------------------------------------
 
diff --git a/doc/devel/development_setup.rst b/doc/devel/development_setup.rst
@@ -144,7 +144,7 @@ The simplest way to do this is to use either Python's virtual environment
 
 Remember to activate the environment whenever you start working on Matplotlib.
 
-Installing Matplotlib in editable mode
+Install Matplotlib in editable mode
 ======================================
 Install Matplotlib in editable mode from the :file:`matplotlib` directory
 using the command ::
diff --git a/doc/devel/index.rst b/doc/devel/index.rst
@@ -8,98 +8,117 @@ Thank you for your interest in helping to improve Matplotlib! There are various
 ways to contribute to Matplotlib. All of them are super valuable but don't necessarily
 require writing code at all. For example:
 
-- contributing to the documentation
-- opening new issues for bugs
-- requesting new features
-- asking for clarification on things you find unclear
-- fixing bugs
-
-If you have any questions on the
-process or how to fix something feel free to ask on `gitter
-<https://gitter.im/matplotlib/matplotlib>`_ for short questions and on
-`discourse <https://discourse.matplotlib.org>`_ for longer questions.
-
 .. rst-class:: sd-d-inline-block
 
-    .. button-ref:: request-a-new-feature
-        :class: sd-fs-6
-        :color: primary
+   .. button-ref:: request-a-new-feature
+      :class: sd-fs-6
+      :color: primary
 
-        Request a feature
+      Request a feature
 
 
 .. rst-class:: sd-d-inline-block
 
-    .. button-ref:: submitting-a-bug-report
-        :class: sd-fs-6
-        :color: primary
+   .. button-ref:: submitting-a-bug-report
+      :class: sd-fs-6
+      :color: primary
 
-        Report a bug
+      Report a bug
 
 .. rst-class:: sd-d-inline-block
 
-    .. button-ref:: contributing-code
-        :class: sd-fs-6
-        :color: primary
+   .. button-ref:: contributing-code
+      :class: sd-fs-6
+      :color: primary
 
-        Contribute code
+      Contribute code
 
 .. rst-class:: sd-d-inline-block
 
-    .. button-ref:: documenting-matplotlib
-        :class: sd-fs-6
-        :color: primary
+   .. button-ref:: documenting-matplotlib
+      :class: sd-fs-6
+      :color: primary
+
+      Write documentation
+
+If you have any questions on the
+process or how to fix something feel free to ask on `gitter
+<https://gitter.im/matplotlib/matplotlib>`_ for short questions and on
+`discourse <https://discourse.matplotlib.org>`_ for longer questions.
 
-        Write documentation
 
 .. card:: Contribute
 
-   .. toctree::
-      :maxdepth: 2
+   .. grid:: 1 1 2 2
+
+      .. grid-item-card::
+
+         :ref:`start-contributing`
+
+         :ref:`get_connected`
+
+         :ref:`new_contributors`
 
-      contribute
+         :ref:`managing_issues_prs`
+
+      .. grid-item-card::
+
+         :ref:`open-an-issue`
+
+         :ref:`contributing-code`
+
+         :ref:`contributing_documentation`
+
+         :ref:`other_ways_to_contribute`
 
 .. card:: Set up working environment
 
     .. toctree::
        :maxdepth: 2
 
        development_setup
-       development_workflow
 
     .. toctree::
        :maxdepth: 1
 
+       development_workflow
        dependencies
        min_dep_policy
 
 
-.. card:: Contributor Guides
+.. card:: Contributor guides
+
+   .. grid:: 1 1 2 2
+
+      .. grid-item-card:: Code
+
+         :ref:`coding_guidelines`
+
+         :doc:`coding_guide`
+
+         :doc:`testing`
+
+      .. grid-item-card:: Documentation
+
+         :doc:`documenting_mpl`
+
+         :doc:`style_guide`
 
-   .. toctree::
-      :maxdepth: 1
+      .. grid-item-card:: Triage
 
-      contributing:coding_guidelines
-      coding_guide
-      testing
+         :ref:`bug_triaging`
 
-   .. toctree::
-      :maxdepth: 1
+         :ref:`triage_team`
 
-      documenting_mpl
-      style_guide
+         :ref:`triage_workflow`
 
-   .. toctree::
-      :maxdepth: 2
+      .. grid-item-card:: Maintenance
 
-      triage
+         :doc:`maintainer_workflow`
 
-   .. toctree::
-      :maxdepth: 1
+         :doc:`release_guide`
 
-      maintainer_workflow
-      release_guide
-      MEP/index
+         :doc:`MEP/index`
 
 .. toctree::
    :hidden:
diff --git a/doc/devel/triage.rst b/doc/devel/triage.rst
@@ -62,6 +62,8 @@ The following actions are typically useful:
    explores how to lead online discussions in the context of open source.
 
 
+.. _triage_team:
+
 Triage team
 -----------
 
@@ -121,6 +123,8 @@ can do the following important tasks:
     should be closed.
 
 
+.. _triage_workflow:
+
 A typical workflow for triaging issues
 --------------------------------------
 
