Skip to content

Commit c231d1c

Browse files
committed
Update EIP 1 with header format changes, fix a few other EIP header issues
1 parent 3e91f85 commit c231d1c

File tree

14 files changed

+50
-34
lines changed

14 files changed

+50
-34
lines changed

EIPS/eip-1.md

Lines changed: 22 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -117,29 +117,31 @@ EIPs should be written in [markdown] format. Image files should be included in a
117117
EIP Header Preamble
118118
-------------------
119119

120-
Each EIP must begin with an RFC 822 style header preamble. The headers must appear in the following order. Headers marked with "*" are optional and are described below. All other headers are required.
120+
Each EIP must begin with an RFC 822 style header preamble, preceded and followed by three hyphens ('---'). The headers must appear in the following order. Headers marked with "*" are optional and are described below. All other headers are required.
121121

122-
` EIP: ` <EIP number> (this is determined by the EIP editor)
122+
` eip: ` <EIP number> (this is determined by the EIP editor)
123123

124-
` Title: `<EIP title>
124+
` title: `<EIP title>
125125

126-
` Author: `<list of author's real names and optionally, email address>
126+
` author: `<list of author's real names and optionally, email address>
127127

128-
` * Discussions-To: ` <email address>
128+
` * discussions-to: ` <email address>
129129

130-
` Status: `<Draft | Active | Accepted | Deferred | Rejected | Withdrawn | Final | Superseded>
130+
` status: `<Draft | Active | Accepted | Deferred | Rejected | Withdrawn | Final | Superseded>
131131

132-
` Type: `<Standards Track (Core, Networking, Interface, ERC) | Informational | Process>
132+
` type: `<Standards Track (Core, Networking, Interface, ERC) | Informational | Process>
133133

134-
` Created: `<date created on, in ISO 8601 (yyyy-mm-dd) format>
134+
` created: `<date created on, in ISO 8601 (yyyy-mm-dd) format>
135135

136-
` * Replaces: `<EIP number>
136+
` * requires: `<EIP number(s)>
137137

138-
` * Superseded-By: `<EIP number>
138+
` * replaces: `<EIP number(s)>
139139

140-
` * Resolution: `<url>
140+
` * superseded-by: `<EIP number(s)>
141141

142-
The Author header lists the names, and optionally the email addresses of all the authors/owners of the EIP. The format of the Author header value must be
142+
` * resolution: `<url>
143+
144+
The author header lists the names, and optionally the email addresses of all the authors/owners of the EIP. The format of the author header value must be
143145

144146
Random J. User &lt;address@dom.ain&gt;
145147

@@ -149,17 +151,19 @@ Random J. User
149151

150152
if the email address is not given.
151153

152-
Note: The Resolution header is required for Standards Track EIPs only. It contains a URL that should point to an email message or other web resource where the pronouncement about the EIP is made.
154+
Note: The resolution header is required for Standards Track EIPs only. It contains a URL that should point to an email message or other web resource where the pronouncement about the EIP is made.
155+
156+
While an EIP is in private discussions (usually during the initial Draft phase), a discussions-to header will indicate the mailing list or URL where the EIP is being discussed. No discussions-to header is necessary if the EIP is being discussed privately with the author.
153157

154-
While an EIP is in private discussions (usually during the initial Draft phase), a Discussions-To header will indicate the mailing list or URL where the EIP is being discussed. No Discussions-To header is necessary if the EIP is being discussed privately with the author.
158+
The type header specifies the type of EIP: Standards Track, Meta, or Informational. If the track is Standards please include the subcategory (core, networking, interface, or ERC).
155159

156-
The Type header specifies the type of EIP: Standards Track, Meta, or Informational. If the track is Standards please include the subcategory (core, networking, interface, or ERC).
160+
The created header records the date that the EIP was assigned a number. Both headers should be in yyyy-mm-dd format, e.g. 2001-08-14.
157161

158-
The Created header records the date that the EIP was assigned a number. Both headers should be in yyyy-mm-dd format, e.g. 2001-08-14.
162+
EIPs may have a requires header, indicating the EIP numbers that this EIP depends on.
159163

160-
EIPs may have a Requires header, indicating the EIP numbers that this EIP depends on.
164+
EIPs may also have a superseded-by header indicating that an EIP has been rendered obsolete by a later document; the value is the number of the EIP that replaces the current document. The newer EIP must have a Replaces header containing the number of the EIP that it rendered obsolete.
161165

162-
EIPs may also have a Superseded-By header indicating that an EIP has been rendered obsolete by a later document; the value is the number of the EIP that replaces the current document. The newer EIP must have a Replaces header containing the number of the EIP that it rendered obsolete.
166+
Headers that permit lists must separate elements with commas.
163167

164168
Auxiliary Files
165169
---------------

EIPS/eip-158.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ type: Standard Track
66
category: Core
77
status: Superseded
88
created: 2016-10-16
9-
Superseded-By: 161
9+
superseded-by: 161
1010
---
1111

1212
# Specification

EIPS/eip-211.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,8 +6,7 @@ type: Standard Track
66
category: Core
77
status: Final
88
created: 2017-02-13
9-
Requires:
10-
Replaces: 5/8
9+
replaces: 5,8
1110
---
1211

1312
## Simple Summary

EIPS/eip-606.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ author: Alex Beregszaszi
55
type: Meta
66
status: Final
77
created: 2017-04-23
8-
Requires: 2, 7
8+
requires: 2, 7
99
---
1010

1111
## Abstract

EIPS/eip-607.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ author: Alex Beregszaszi
55
type: Meta
66
status: Final
77
created: 2017-04-23
8-
Requires: 155, 160, 161, 170
8+
requires: 155, 160, 161, 170
99
---
1010

1111
## Abstract

EIPS/eip-608.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ author: Alex Beregszaszi
55
type: Meta
66
status: Final
77
created: 2017-04-23
8-
Requires: 150
8+
requires: 150
99
---
1010

1111
## Abstract

EIPS/eip-609.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ type: Standard Track
66
category: Core
77
status: Final
88
created: 2017-04-23
9-
Requires: 100, 140, 196, 197, 198, 211, 214, 649, 658
9+
requires: 100, 140, 196, 197, 198, 211, 214, 649, 658
1010
---
1111

1212
## Abstract

EIPS/eip-615.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ status: Draft
55
type: Core
66
author: Greg Colvin <greg@colvin.org>, Paweł Bylica, Christian Reitwiessner
77
created: 2016-12-10
8-
Edited: 2017-25-4
8+
edited: 2017-25-4
99
---
1010

1111
## Abstract

EIPS/eip-649.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ type: Standard Track
66
category: Core
77
status: Final
88
created: 2017-06-21
9-
Replaces: 186
9+
replaces: 186
1010
---
1111

1212
## Simple Summary

EIPS/eip-658.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,8 +6,8 @@ type: Standard Track
66
category: Core
77
status: Final
88
created: 2017-06-30
9-
Requires: 140
10-
Replaces: 98
9+
requires: 140
10+
replaces: 98
1111
---
1212

1313
## Abstract

0 commit comments

Comments
 (0)