Skip to content

Commit

Permalink
Update and rename oep-0063-proc-toc-appeal.rst to oep-0063-proc-toc-a…
Browse files Browse the repository at this point in the history
…rbitration.rst
  • Loading branch information
antoviaque authored May 29, 2023
1 parent 3a00919 commit 08bb8b2
Showing 1 changed file with 23 additions and 18 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -2,18 +2,18 @@

.. Below is the display in the left sidebar on RTD. Please omit leading 0's
OEP-63: TOC Appeal
##################
OEP-63: TOC Arbitration
#######################

.. list-table::
:widths: 25 75

* - OEP
- :doc:`OEP-0063 <oep-0063-proc-toc-appeal>`
- :doc:`OEP-0063 <oep-0063-proc-toc-arbitration>`
* - Title
- TOC Appeal
- TOC Arbitration
* - Last Modified
- 2023-05-18
- 2023-05-29
* - Authors
- Xavier Antoviaque
* - Arbiter
Expand All @@ -38,7 +38,7 @@ The Technical Oversight Committee (TOC) aims to empower the project's contributo

However, some of the decisions can sometimes be complex: lack of consensus, decisions with long-lasting reprecussions. This can result in delaying taking *any* decision, which can be more hurtful than any of the choices.

In this OEP, the TOC defines a process for community members to bring up topics to the board's attention, and request to take a decision about a proposal (an "Appeal").
In this OEP, the TOC defines a process for community members to bring up topics to the board's attention, and request to take a decision about a proposal (an "Arbitration").

Motivation
**********
Expand Down Expand Up @@ -66,30 +66,30 @@ From the `TOC meeting notes <https://discuss.openedx.org/t/2023-04-11-toc-meetin
Specification
*************

- Appeals can be posted by anyone in the community - but need to be supported by at least two core contributors or a TOC member
- The TOC members are encouraged to participate in community discussions early on, before the TOC is asked to take the final decision.
- Requests for arbitration can be posted by anyone in the community - but need to be supported by at least two core contributors or a TOC member
- The TOC members are encouraged to participate in community discussions early on, before the TOC is asked to arbitrate.

Step-by-step - How to submit an appeal
======================================
Step-by-step - How to submit an arbitration
===========================================

- Open a discussion in a public place, such as the `forum <discuss.openedx.org/>`_ or using one of the formal decision recording formats such as `OEPs <https://open-edx-proposals.readthedocs.io/en/latest/>`_. The topics presented need to have been discussed in the community before being formally considered by the TOC.
- After public review, post a formal request to appeal to the TOC. This can be done in a forum post or a `github ticket <https://github.com/openedx/wg-coordination/issues/new>`_ mentioning the TOC chair (@e0d). See the format below.
- Core contributors and/or TOC members supporting the appeal reply in the thread to say so
- After public review, post a formal arbitration request to the TOC. This can be done in a forum post or a `github ticket <https://github.com/openedx/wg-coordination/issues/new>`_ mentioning the TOC chair (@e0d). See the format below.
- Core contributors and/or TOC members supporting the arbitration reply in the thread to say so.
- If the requirements are met, the TOC will schedule the topic for a future meeting.
- If the appeal contains a suggested decision, the TOC can choose to accept the suggested decision, with or without changes, or to refuse it.
- The decision is communicated as a reply to the forum thread of the appeal, with a comment to explain the decision.
- If the arbitration contains a suggested decision, the TOC can choose to accept the suggested decision, with or without changes, or to refuse it.
- The outcome of the arbitration is communicated as a reply to the forum thread of the arbitration, with a comment to explain the decision.

Appeal - Post template (forum or github)
========================================
Arbitration - Post template (forum or github)
=============================================

.. code-block:: none
Subj: TOC Appeal - [Title for the appeal]
Subj: TOC Arbitration - [Title for the arbitration]
Category: Community
---------------------
## [Title for the appeal]
## [Title for the arbitration]
## Summary
[Prior discussion of this topic (with links)]
Expand All @@ -103,6 +103,11 @@ Appeal - Post template (forum or github)
Change History
**************

2023-05-29
==========

* Changed the name of the procedure from "appeal" to "arbitration" to address review comments.

2023-05-18
==========

Expand Down

0 comments on commit 08bb8b2

Please sign in to comment.