EIP-5069 - EIP Editor Handbook

Created 2022-05-02
Status Living
Type Meta
Authors
Requires

Introduction

We, the Ethereum Improvement Proposal (EIP) Editors, maintain a repository of documents related to the Ethereum protocol and its ecosystem. Consider us both archivists making sure the community as a whole does not lose its history, and a publisher making sure interested parties can stay up-to-date with the latest proposals.

Mission

What we Do

Our mission is to serve the broad Ethereum community, both present and future, by:

What we Don't

On the other hand, we do not:

Documenting all of the things we would not do is impossible, and the above are just a few examples. We reserve the right to do less work whenever possible!

Structure

EIP Editors

We, the Editors, consist of some number of EIP Editors and one Keeper of Consensus (or just Keeper for short) elected by and from the EIP Editors.

EIP Editors are responsible for governing the EIP process itself, electing a Keeper, and stewarding proposals.

The Keeper's two responsibilities (on top of their EIP Editor duties) are: to determine when rough consensus has been reached on a matter, and determine when/if it is appropriate to re-open an already settled matter.

EIP Coordinators

Alongside the Editors, we recognize zero or more EIP Coordinators selected by the EIP Editors.

EIP Coordinators support the operational and educational aspects of the EIP process by helping authors navigate the process, following up on process-related work, and maintaining relevant documentation. They do not perform editorial review or determine whether a proposal is accepted or rejected.

Editors may delegate mechanical administrative work to Coordinators as described under Membership.

Membership

Becoming an EIP Editor

Anyone may apply to join as an EIP Editor. Specific eligibility requirements are left to individual current EIP Editors, but the general requirements are:

EIP Editors are expected to meet these requirements throughout their tenure, and not doing so is grounds for removal. Any member may delegate some or all of their responsibilities/powers to tools and/or to other people.

Becoming an EIP Coordinator

In addition to the EIP Editor membership requirements above, EIP Coordinators are expected to demonstrate:

EIP Coordinators do not need to meet the requirements for reading and critiquing the technical content of EIPs or participation in governance, as these responsibilities remain with EIP Editors. EIP Coordinators are expected to meet these requirements throughout their tenure, and not doing so is grounds for removal.

Making Decisions

Informally

For decisions that are unlikely to be controversial—especially for decisions affecting a single proposal—an EIP Editor may choose whatever option they deem appropriate in accordance with our mission.

Formally

Electing a Keeper, adding/removing EIP Editors, adding/removing EIP Coordinators, and any possibly-controversial decisions must all be made using variations of this formal process.

Preparation

Call for Input

For any matter requiring a decision, a call for input must be published in writing to the usual channels frequented by EIP Editors.

Quorum

Within thirty days of the call for input, to establish a valid quorum, all EIP Editors must express their opinion, vote (where appropriate), or lack thereof on the matter under consideration.

After thirty days from the call for input, if not all EIP Editors have responded, the quorum is reduced to the Editors that have responded. This deadline may be extended in exceptional situations.

Deciding

Electing a Keeper of Consensus

Any EIP Editor can call for an election for Keeper. Business continues as usual while the election is running. The EIP Editor with the most votes once quorum is met is named Keeper until the next election completes. If there is a tie, we'll randomly choose between the EIP Editors with the most votes, using a fair and agreed upon method (for example, a coin toss over a video call or a commit/reveal game of rock paper scissors.)

Adding an EIP Editor

An EIP Editor is added once quorum is met, provided the candidate consents and no current EIP Editor objects.

Removing an EIP Editor

An EIP Editor is involuntarily retired once quorum is met, provided no current EIP Editor (aside from the one being removed) objects. An EIP Editor may voluntarily leave their position at any time.

If the departing Editor was also the Keeper, an election for a new Keeper begins immediately.

Adding or Removing an EIP Coordinator

An EIP Coordinator is added or involuntarily removed through the "rough consensus" process described under Other Decisions below, provided (when adding) the candidate consents. An EIP Coordinator may voluntarily leave their position at any time.

EIP Coordinator Participation in Decisions

EIP Coordinators do not have voting rights and do not participate in determining rough consensus. They may provide process-related information, operational context, and feedback to EIP Editors, but decision-making authority remains with the EIP Editors as defined above.

Other Decisions

All other decisions (including, for example, adding EIP coordinators) are made through a "rough consensus" process. This does not require all EIP Editors to agree, although this is preferred. In general, the dominant view of the Editors shall prevail. Dominance, in this process, is not determined by persistence or volume but rather a more general sense of agreement. Note that 51% does not mean "rough consensus" has been reached, and 99% is better than rough. It is up to the Keeper to determine if rough consensus has been reached. Every EIP Editor is entitled to have their opinion heard and understood before the Keeper makes that determination.

No one, not the EIP Editors and certainly not the Keeper, holds veto powers (except when adding/removing an Editor as defined above.) It is imperative that the EIP process evolve, albeit cautiously.

This section has been adapted from RFC 2418.

Copyright

Copyright and related rights waived via CC0.