Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add EIP-5069: EIP editor handbook in EIP form #5069

Merged
merged 29 commits into from
Jun 28, 2022
Merged
Show file tree
Hide file tree
Changes from 25 commits
Commits
Show all changes
29 commits
Select commit Hold shift + click to select a range
7e18aaf
Create eip-apprentice-handbook.md
Pandapip1 May 2, 2022
78c29a5
I'll assume I'll be given 5069
Pandapip1 May 2, 2022
b2ceb35
First pass through
Pandapip1 May 2, 2022
057fd6a
Small grammar mistake
Pandapip1 May 3, 2022
0eee74f
Fix typo
Pandapip1 May 3, 2022
3728c8b
Fix grammar
Pandapip1 May 3, 2022
dc56e8c
Fix malformed date
Pandapip1 May 3, 2022
a03fa83
Fix more typos
Pandapip1 May 3, 2022
81e4c85
Add note to readme
Pandapip1 May 3, 2022
5540bff
Add link in EIP-1
Pandapip1 May 3, 2022
4707c0f
Remove extra lines
Pandapip1 May 3, 2022
e54b49a
Lowercase e
Pandapip1 May 3, 2022
ee3aa6d
Pooja agreed that I should be an author
Pandapip1 May 3, 2022
aceaf63
Update discussions-to
Pandapip1 May 3, 2022
6990b17
Fix broken link
Pandapip1 May 4, 2022
70f19a5
Meta -> Info
Pandapip1 May 9, 2022
1af8848
Change to living, make author list infinite
Pandapip1 May 13, 2022
148e38e
Make quite a few changes
Pandapip1 May 13, 2022
458cc48
Update to use new licence
Pandapip1 May 13, 2022
c51d5e5
It's licenSe
Pandapip1 May 13, 2022
f12fd6b
Forgot the .md
Pandapip1 May 13, 2022
249bf90
Apply suggestions from code review
Pandapip1 May 18, 2022
9d159cb
Apply suggestions from code review
Pandapip1 May 27, 2022
24927c2
Remove motivation section
Pandapip1 May 27, 2022
5872290
Deduplicate EIP-1
Pandapip1 May 27, 2022
951e17a
Remove all instances of apprentice and the mentorship program
Pandapip1 May 31, 2022
46d0a1a
Apply suggestions from code review
Pandapip1 Jun 3, 2022
40b073c
Add diff
Pandapip1 Jun 3, 2022
2b40b1f
Single PR
Pandapip1 Jun 14, 2022
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions EIPS/eip-1.md
Original file line number Diff line number Diff line change
Expand Up @@ -222,6 +222,8 @@ Emeritus EIP editors are
- Nick Savers (@nicksavers)
- Martin Becze (@wanderer)

If you would like to become an EIP editor, please check [EIP-5069](./eip-5069.md).

## EIP Editor Responsibilities

For each new EIP that comes in, an editor does the following:
Expand Down
47 changes: 47 additions & 0 deletions EIPS/eip-5069.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,47 @@
---
eip: 5069
title: EIP Editor Apprentice Handbook
description: Formalizes the process for becoming an EIP editor
Pandapip1 marked this conversation as resolved.
Show resolved Hide resolved
author: Pooja Ranjan (@poojaranjan), Pandapip1 (@Pandapip1)
discussions-to: https://ethereum-magicians.org/t/pr-5069-eip-editor-apprentice-handbook/9137
status: Living
type: Informational
created: 2022-05-02
requires: 1
---

## Abstract
An Ethereum Improvement Proposal (EIP) is a design document providing information to the Ethereum community, or describing a new feature for Ethereum or its processes or environment. The EIP standardization process is a mechanism for proposing new features, for collecting community technical input on an issue, and for documenting the design decisions that have gone into Ethereum. Because improvement proposals are key components of Ethereum blockchain, it is important that they are well reviewed before reaching `Final` status. EIPs are stored in text files in a versioned repository which is monitored by the EIP editors.

This EIP describes the recommended process for becoming an EIP editor.

## Specification
Pandapip1 marked this conversation as resolved.
Show resolved Hide resolved
The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in RFC 2119.

### Application and Onboarding Process
Any contributor of Ethereum ecosystem, having a good understanding of EIP standardization and network upgrade process, intermediate level experience on the core and/or application side of the Ethereum blockchain, and willingness to contribute to the process management MAY apply to become an EIP editor. Potential EIP editors SHOULD have the following skills:
Pandapip1 marked this conversation as resolved.
Show resolved Hide resolved
- Good communication skills
- Ability to handle contentious discourse
- 1-5 spare hours per week

The best available resource to understand the EIP process is [EIP-1](./eip-1.md). EIP editor apprentices MUST understand this document. Afterwards, participating in the EIP process by commenting on and suggesting improvements to PRs and issues will familliarize apprentices with the procedure, and is RECOMMENDED. The contributions of apprentice editors SHALL be monitored by other EIP editors.

When the apprentice feels comfortable with the process, a pull request with a request to be listed as EIP editor MAY be made. If the existing EIP editors agree, the apprentice SHALL become a full EIP editor. This SHALL notify the editor of relevant new proposals submitted in the EIPs repository, and they SHALL review and merge pull requests. Once the first PR is merged, another pull request to update the editor list SHALL be made.

The following are external links to example pull requests:
- Add Sam Wilson as an editor: https://github.com/ethereum/EIPs/pull/4859
Pandapip1 marked this conversation as resolved.
Show resolved Hide resolved

### EIP Editor Mentorship Program
The EIP Editor Mentorship Program is an initiative by the Ethereum Cat Herders to attract potential talent of the community to accelerate and improve the EIP standardization process. The EIP Editor Mentorship Program includes completing editorial tasks under the guidance of more experienced editors for the initial 3 months as an EIP editor trainee, to provide support until trainees are confident with the process and ready to work independently.

The EIP Editor Mentorship Program is RECOMMENDED.

### Special Merging Rules for this EIP
This EIP MUST have the same rules regarding changes as [EIP-1](./eip-1.md).

## Rationale
- "6 months" was chosen as the cutoff for denoting `Stagnant` EIPs terminally-`Stagnant` arbitrarily.
- This EIP requires special merging rules for the same reason [EIP-1](./eip-1.md) does.

## Copyright
Copyright and related rights waived via [CC0](../LICENSE.md).
2 changes: 2 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,8 @@ This repository tracks ongoing improvements to Ethereum. It contains:

For help *implementing* an EIP, please visit [Ethereum Stack Exchange](https://ethereum.stackexchange.com).

If you would like to become an EIP Editor, please check [EIP-5069](./EIPS/eip-5069.md).

## Mission

The goal of the EIP project is to document standardized protocols for Ethereum clients and applications and to document them in a high quality and implementable way.
Expand Down