Backport PR #10987: DOC: better document the MEP process

dstansby · MeeseeksDev[bot] · commit 231c0968380e · 2018-04-08T10:03:11.000Z
diff --git a/doc/devel/MEP/MEP08.rst b/doc/devel/MEP/MEP08.rst
@@ -9,7 +9,9 @@
 Status
 ======
 
-**Discussion**
+**Completed**
+
+We are currently enforcing a sub-set of pep8 on new code contributions.
 
 Branches and Pull requests
 ==========================
diff --git a/doc/devel/MEP/MEP09.rst b/doc/devel/MEP/MEP09.rst
@@ -11,6 +11,7 @@ by the user.
 
 Status
 ======
+
 **Discussion**
 
 Branches and Pull requests
diff --git a/doc/devel/MEP/MEP10.rst b/doc/devel/MEP/MEP10.rst
@@ -9,14 +9,11 @@ Status
 
 **Progress**
 
-Targeted for 1.3
+This is still an on-going effort
 
 Branches and Pull requests
 ==========================
 
-#1665
-#1757
-#1795
 
 Abstract
 ========
diff --git a/doc/devel/MEP/MEP19.rst b/doc/devel/MEP/MEP19.rst
@@ -5,7 +5,7 @@
 Status
 ======
 
-**Discussion**
+**Completed**
 
 Branches and Pull requests
 ==========================
diff --git a/doc/devel/MEP/MEP26.rst b/doc/devel/MEP/MEP26.rst
@@ -9,7 +9,7 @@
 Status
 ======
 
-**Proposed**
+**Rejected**
 
 Branches and Pull requests
 ==========================
diff --git a/doc/devel/MEP/MEP27.rst b/doc/devel/MEP/MEP27.rst
@@ -8,7 +8,7 @@
 
 Status
 ======
-**Discussion**
+**Progress**
 
 Branches and Pull requests
 ==========================
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
 ==========================
 
