DOC: better document the MEP process

tacaswell · tacaswell · commit 821a386c147b · 2018-04-08T00:18:10.000-04:00
diff --git a/doc/devel/MEP/README.rst b/doc/devel/MEP/README.rst
@@ -0,0 +1,18 @@
+:orphan:
+
+
+################################
+Matplotlib Enhancement Proposals
+################################
+
+Matplotlib Enhancement Proposals (MEP), inspired by cpython's `PEP's
+<https://www.python.org/dev/peps/>`__ but less formal, are design
+documents for large or controversial changes to Matplotilb.  These
+documents should provide a discussion of both why and how the changes
+should be made.
+
+To create a new MEP open a pull request (PR) adding a file based on
+:ref:`the template <MEP-template>` to this the MEP directory.  For the
+initial PR only a rough description is required and it should be
+merged quickly.  Further detailed discussion can happen in follow on
+PRs.
diff --git a/doc/devel/MEP/index.rst b/doc/devel/MEP/index.rst
@@ -1,8 +1,6 @@
 .. _MEP-index:
 
-################################
-Matplotlib Enhancement Proposals
-################################
+.. include:: README.rst
 
 .. htmlonly::
 
@@ -13,22 +11,9 @@ Matplotlib Enhancement Proposals
    :maxdepth: 1
 
    template
-   MEP08
-   MEP09
-   MEP10
-   MEP11
-   MEP12
-   MEP13
-   MEP14
-   MEP15
-   MEP19
-   MEP21
-   MEP22
-   MEP23
-   MEP24
-   MEP25
-   MEP26
-   MEP27
-   MEP28
-   MEP29
 
+.. toctree::
+   :glob:
+   :maxdepth: 1
+
+   MEP*
diff --git a/doc/devel/MEP/template.rst b/doc/devel/MEP/template.rst
@@ -1,3 +1,5 @@
+.. _MEP-template:
+
 ==============
  MEP Template
 ==============
@@ -20,14 +22,15 @@ MEPs go through a number of phases in their lifetime:
   discussion of the MEP should include the MEP number (MEPxxx) in the
   subject line so they can be easily related to the MEP.
 
-- **Progress**: Consensus was reached on the mailing list and
-  implementation work has begun.
+- **Progress**: Consensus was reached and implementation work has begun.
 
 - **Completed**: The implementation has been merged into master.
 
 - **Superseded**: This MEP has been abandoned in favor of another
   approach.
 
+- **Rejected**: There are currently no plans to implement the proposal.
+
 Branches and Pull requests
 ==========================
 
