reorganize contribute page into blocks and cards

story645 · story645 · commit 4416d385cc76 · 2023-06-21T21:40:59.000-04:00
diff --git a/doc/devel/contribute.rst b/doc/devel/contribute.rst
@@ -18,6 +18,8 @@ contribute. Everyone within the community
 is expected to abide by our
 `code of conduct <https://github.com/matplotlib/matplotlib/blob/main/CODE_OF_CONDUCT.md>`_.
 
+
+
 Below, you can find a number of ways to contribute, and how to connect with the
 Matplotlib community.
 
@@ -77,7 +79,9 @@ 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:
+
+Get connected
 =============
 
 Do I really have something to contribute to Matplotlib?
@@ -145,6 +149,7 @@ 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:
 
 Work on an issue
 ----------------
diff --git a/doc/devel/development_setup.rst b/doc/devel/development_setup.rst
@@ -148,7 +148,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/development_workflow.rst b/doc/devel/development_workflow.rst
@@ -145,8 +145,8 @@ If you don't think your request is ready to be merged, just say so in your pull
 request message and use the "Draft PR" feature of GitHub. This is a good way of
 getting some preliminary code review.
 
-Some other things you might want to do
-======================================
+Manage a pull request
+======================
 
 Explore your repository
 -----------------------
@@ -163,7 +163,7 @@ To see a linear list of commits for this branch::
 
 .. _recovering-from-mess-up:
 
-Recovering from mess-ups
+Recover from mistakes
 ------------------------
 
 Sometimes, you mess up merges or rebases. Luckily, in git it is
@@ -193,7 +193,7 @@ If you forgot to make a backup branch::
 
 .. _rewriting-commit-history:
 
-Rewriting commit history
+Rewrite commit history
 ------------------------
 
 .. note::
@@ -285,7 +285,7 @@ to replace your already published commits with the new ones.
 
 .. _rebase-on-main:
 
-Rebasing on ``upstream/main``
+Rebase onto ``upstream/main``
 -----------------------------
 
 Let's say you thought of some work you'd like to do. You
@@ -363,7 +363,7 @@ to replace your already published commits with the new ones.
 .. _force-push:
 
 
-Pushing, with force
+Push with force
 -------------------
 
 
diff --git a/doc/devel/index.rst b/doc/devel/index.rst
@@ -5,69 +5,135 @@ Contribute
 ##########
 
 Thank you for your interest in helping to improve Matplotlib! There are various
-ways to contribute to Matplotlib. All of them are super valuable! For example:
+ways to contribute: optimizing and refactoring code, detailing unclear
+documentation and writing new examples, reporting and fixing bugs and requesting
+and implementing new features, helping the community...
 
-- cleaning up and optimizing the code base
-- creating and sharing examples of using the library
-- detailing unclear and missing documentation
-- reporting and fixing bugs
-- requesting and implementing new features
-- helping the community with all of the above
+.. grid:: 1 1 2 2
 
+   .. grid-item-card::
+      :class-body: sd-fs-5
 
-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.
+      :octicon:`info;1em;sd-text-info` :ref:`start-contributing`
 
-.. rst-class:: sd-d-inline-block
+      :octicon:`question;1em;sd-text-info` :ref:`get_connected`
 
-    .. button-ref:: submitting-a-bug-report
-        :class: sd-fs-6
-        :color: primary
+      :octicon:`issue-opened;1em;sd-text-info` :ref:`new_contributors`
 
-        Report a bug
+      :octicon:`git-pull-request;1em;sd-text-info` :ref:`managing_issues_prs`
 
-.. rst-class:: sd-d-inline-block
+   .. grid-item::
 
-    .. button-ref:: request-a-new-feature
-        :class: sd-fs-6
-        :color: primary
+      .. rst-class:: sd-d-inline-block
 
-        Request a feature
+         .. button-ref:: request-a-new-feature
+            :class: sd-fs-6
+            :color: primary
 
-.. rst-class:: sd-d-inline-block
+            Request a feature
 
-    .. button-ref:: contributing-code
-        :class: sd-fs-6
-        :color: primary
 
-        Contribute code
+      .. rst-class:: sd-d-inline-block
 
-.. rst-class:: sd-d-inline-block
+         .. button-ref:: submitting-a-bug-report
+            :class: sd-fs-6
+            :color: primary
 
-    .. button-ref:: documenting-matplotlib
-        :class: sd-fs-6
-        :color: primary
+            Report a bug
 
-        Write documentation
+      .. rst-class:: sd-d-inline-block
 
-.. toctree::
-   :maxdepth: 2
-
-   contribute.rst
-   triage.rst
-   development_setup.rst
-   development_workflow.rst
-   testing.rst
-   document.rst
-   style_guide.rst
-   coding_guide.rst
-   release_guide.rst
-   dependencies.rst
-   min_dep_policy.rst
-   maintainer_workflow.rst
-   MEP/index
+         .. button-ref:: contributing-code
+            :class: sd-fs-6
+            :color: primary
+
+            Contribute code
+
+      .. rst-class:: sd-d-inline-block
+
+         .. button-ref:: documenting-matplotlib
+            :class: sd-fs-6
+            :color: primary
+
+            Write documentation
+
+If you are new to contributing, we recommend that you first read our
+:ref:`contributing guide<contributing>`. If you are contributing code or
+documentation, please follow our guides for setting up and managing a
+:ref:`development environment and workflow<development_environment>`.
+For code, documentation, or triage, please follow the corresponding
+:ref:`contribution guidelines <contribution_guideline>`.
+
+
+.. _development_environment:
+
+Develop
+=======
+
+.. grid:: 1 1 2 2
+
+   .. grid-item-card:: Setup
+
+      .. toctree::
+         :maxdepth: 2
+
+         development_setup
+
+      .. toctree::
+         :maxdepth: 1
+
+         dependencies
+         Minimum versions <min_dep_policy>
+
+
+   .. grid-item-card:: Workflow
+
+      .. toctree::
+         :maxdepth: 2
+
+         development_workflow
+
+
+
+.. _contribution_guideline:
+
+Contribution guidelines
+=======================
+
+.. grid:: 1 1 2 2
+
+   .. grid-item-card:: Code
+
+      :ref:`coding_guidelines`
+
+      .. toctree::
+         :maxdepth: 1
+
+         coding_guide
+         testing
+
+   .. grid-item-card:: Documentation
+
+      .. toctree::
+         :maxdepth: 1
+
+         document
+         style_guide
+
+   .. grid-item-card:: Triage
+
+      | :ref:`bug_triaging`
+      | :ref:`triage_team`
+      | :ref:`triage_workflow`
+
+   .. grid-item-card:: Maintenance
+
+      .. toctree::
+         :maxdepth: 1
+
+         maintainer_workflow
+         release_guide
+         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
 --------------------------------------
 
