Skip to content

Commit

Permalink
Update EIP 1 with header format changes, fix a few other EIP header i…
Browse files Browse the repository at this point in the history
…ssues
  • Loading branch information
Arachnid committed Mar 21, 2018
1 parent 3e91f85 commit c231d1c
Show file tree
Hide file tree
Showing 14 changed files with 50 additions and 34 deletions.
40 changes: 22 additions & 18 deletions EIPS/eip-1.md
Original file line number Diff line number Diff line change
Expand Up @@ -117,29 +117,31 @@ EIPs should be written in [markdown] format. Image files should be included in a
EIP Header Preamble
-------------------

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.
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.

` EIP: ` <EIP number> (this is determined by the EIP editor)
` eip: ` <EIP number> (this is determined by the EIP editor)

` Title: `<EIP title>
` title: `<EIP title>

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

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

` Status: `<Draft | Active | Accepted | Deferred | Rejected | Withdrawn | Final | Superseded>
` status: `<Draft | Active | Accepted | Deferred | Rejected | Withdrawn | Final | Superseded>

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

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

` * Replaces: `<EIP number>
` * requires: `<EIP number(s)>

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

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

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
` * resolution: `<url>

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

Random J. User &lt;[email protected]&gt;

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

if the email address is not given.

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.
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.

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.

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.
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).

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).
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.

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.
EIPs may have a requires header, indicating the EIP numbers that this EIP depends on.

EIPs may have a Requires header, indicating the EIP numbers that this EIP depends on.
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.

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.
Headers that permit lists must separate elements with commas.

Auxiliary Files
---------------
Expand Down
2 changes: 1 addition & 1 deletion EIPS/eip-158.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ type: Standard Track
category: Core
status: Superseded
created: 2016-10-16
Superseded-By: 161
superseded-by: 161
---

# Specification
Expand Down
3 changes: 1 addition & 2 deletions EIPS/eip-211.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,7 @@ type: Standard Track
category: Core
status: Final
created: 2017-02-13
Requires:
Replaces: 5/8
replaces: 5,8
---

## Simple Summary
Expand Down
2 changes: 1 addition & 1 deletion EIPS/eip-606.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ author: Alex Beregszaszi
type: Meta
status: Final
created: 2017-04-23
Requires: 2, 7
requires: 2, 7
---

## Abstract
Expand Down
2 changes: 1 addition & 1 deletion EIPS/eip-607.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ author: Alex Beregszaszi
type: Meta
status: Final
created: 2017-04-23
Requires: 155, 160, 161, 170
requires: 155, 160, 161, 170
---

## Abstract
Expand Down
2 changes: 1 addition & 1 deletion EIPS/eip-608.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ author: Alex Beregszaszi
type: Meta
status: Final
created: 2017-04-23
Requires: 150
requires: 150
---

## Abstract
Expand Down
2 changes: 1 addition & 1 deletion EIPS/eip-609.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ type: Standard Track
category: Core
status: Final
created: 2017-04-23
Requires: 100, 140, 196, 197, 198, 211, 214, 649, 658
requires: 100, 140, 196, 197, 198, 211, 214, 649, 658
---

## Abstract
Expand Down
2 changes: 1 addition & 1 deletion EIPS/eip-615.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ status: Draft
type: Core
author: Greg Colvin <[email protected]>, Paweł Bylica, Christian Reitwiessner
created: 2016-12-10
Edited: 2017-25-4
edited: 2017-25-4
---

## Abstract
Expand Down
2 changes: 1 addition & 1 deletion EIPS/eip-649.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ type: Standard Track
category: Core
status: Final
created: 2017-06-21
Replaces: 186
replaces: 186
---

## Simple Summary
Expand Down
4 changes: 2 additions & 2 deletions EIPS/eip-658.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,8 @@ type: Standard Track
category: Core
status: Final
created: 2017-06-30
Requires: 140
Replaces: 98
requires: 140
replaces: 98
---

## Abstract
Expand Down
2 changes: 1 addition & 1 deletion EIPS/eip-681.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ type: Standard Track
category: ERC
status: Draft
created: 2017-08-01
Requires: 20, 137, 831
requires: 20, 137, 831
---

## Simple Summary
Expand Down
2 changes: 1 addition & 1 deletion EIPS/eip-721.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ type: Standard
category: ERC
status: Draft
created: 2018-01-24
Requires: ERC-165
requires: ERC-165
---

## Simple Summary
Expand Down
2 changes: 1 addition & 1 deletion EIPS/eip-868.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ type: Standard Track
category: Networking
status: Draft
created: 2018-02-02
Requires: EIP-8, EIP-778
requires: 8, 778
---

# Abstract
Expand Down
17 changes: 15 additions & 2 deletions _layouts/eip.html
Original file line number Diff line number Diff line change
Expand Up @@ -7,11 +7,24 @@ <h1 class="page-heading">EIP {{ page.eip | xml_escape }}: {{ page.title | xml_es

<table>
<tr><th>Author</th><td>{{ page.author | xml_escape }}</td></tr>
{% if page["discussions-to"] != undefined %}
<tr><th>Discussions-To</th><td>{{ page["discussions-to"] | xml_escape }}</td></tr>
{% endif %}
<tr><th>Status</th><td>{{ page.status | xml_escape }}</td></tr>
<tr><th>Type</th><td>{{ page.type | xml_escape }}</td></tr>
<tr><th>Layer</th><td>{{ page.layer | xml_escape }}</td></tr>
<tr><th>Category</th><td>{{ page.category | xml_escape }}</td></tr>
<tr><th>Created</th><td>{{ page.created | xml_escape }}</td></tr>
{% if page.requires != undefined %}
<tr><th>Requires</th><td>{{ page.requires | xml_escape }}</td></tr>
{% endif %}
{% if page.replaces != undefined %}
<tr><th>Replaces</th><td>{{ page.replaces | xml_escape }}</td></tr>
{% endif %}
{% if page["superseded-by"] != undefined %}
<tr><th>Superseded by</th><td>{{ page["superseded-by"] | xml_escape }}</td></tr>
{% endif %}
{% if page.resolution != undefined %}
<tr><th>Resolution</th><td>{{ page.resolution | xml_escape }}</td></tr>
{% endif %}
</table>

{{ content }}
Expand Down

0 comments on commit c231d1c

Please sign in to comment.