Add a Needs Revision status for OEPs

oeps/architectural-decisions/oep-0045-arch-ops-and-config.rst

@@ -9,13 +9,15 @@ OEP-45: Configuring and Operating Open edX
    * - Title
      - Configuring and Operating Open edX
    * - Last Modified
-     - 2020-04-06
+     - 2024-05-17
    * - Authors
      - Bill DeRusha <[email protected]>
    * - Arbiter
      - Felipe Montoya <[email protected]>
    * - Status
-     - Accepted
+     - Needs Revision
+   * - Revision Ticket
+     - https://github.com/openedx/open-edx-proposals/issues/587
    * - Type
      - Architecture
    * - Created
@@ -210,3 +212,10 @@ The following related decisions modify or enhance this OEP, but have not yet bee
 
    oep-0045/decisions/*
 
+Change History
+**************
+
+2024-05-16
+==========
+* Change status to "Needs Revision"
+* `Pull request #586 <https://github.com/openedx/open-edx-proposals/pull/586>`_

oeps/processes/oep-0001.rst

@@ -8,11 +8,11 @@ OEP-1: OEP Purpose and Guidelines
 +---------------+--------------------------------------------------------------+
 | Last-Modified | 2022-06-22                                                   |
 +---------------+--------------------------------------------------------------+
-| Authors       | Calen Pennington <[email protected]>,                             |
-|               | Joel Barciauskas <[email protected]>,                             |
-|               | Nimisha Asthagiri <[email protected]>,                         |
-|               | Feanil Patel <[email protected]>,                              |
-|               | Sarina Canelake <[email protected]>                            |
+| Authors       | - Calen Pennington <[email protected]>                            |
+|               | - Joel Barciauskas <[email protected]>                            |
+|               | - Nimisha Asthagiri <[email protected]>                        |
+|               | - Feanil Patel <[email protected]>                             |
+|               | - Sarina Canelake <[email protected]>                          |
 +---------------+--------------------------------------------------------------+
 | Arbiter       | - Eddie Fagin <[email protected]>,                              |
 |               | - Calen Pennington <[email protected]>                            |
@@ -242,10 +242,11 @@ OEP Status
         [fontname=Arial]
 
         "Draft" -> { "Under Review" "Deferred" }
+        "Needs Revision" -> "Under Review"
         "Under Review" -> { "Deferred" "Provisional" } [dir=both]
         "Under Review" ->  { "Accepted" "Rejected" "Withdrawn" }
         "Accepted" -> "Final"
-        "Final" -> { "Replaced" "Obsolete" } [style=dashed] [style=dashed]
+        "Final" -> { "Replaced" "Obsolete" "Needs Revision" } [style=dashed] [style=dashed]
     }
 
 Draft
@@ -308,6 +309,19 @@ guidelines. In this case the OEP's status should be changed to "Obsolete" and
 the OEP should be updated with an explanation as to why the OEP is no
 longer relevant.
 
+Needs Revision
+--------------
+
+Over time, some OEPs may stay relevant - for example, they may have many
+sections or core ideas that are still relevant to the project - while containing
+many details that have become stale over time. When we are in agreement that the
+OEP needs updating, we use this status to indicate to those browsing the OEPs
+that this particular one requires some renewed attention.
+
+When changing status to "Needs Revision", a row titled "Revision Ticket" should
+be added to the preamble (directly under the status field) that directs to the
+GitHub issue or draft pull request in the ``open-edx-proposals`` repository that
+describes what about the OEP that needs revisioning.
 
 Status changes
 --------------
@@ -552,6 +566,11 @@ at the top of the list.
 Change History
 **************
 
+2024-05-16
+==========
+* Add a "Needs Revision" status
+* `Pull request #586 <https://github.com/openedx/open-edx-proposals/pull/586>`_
+
 2022-10-05
 ==========
 * Require OEPs merged as "Draft" or "Provisional" to provide a reference for