Skip to content

Commit 4de0d0a

Browse files
committed
BIP3: Reformat Changes from BIP 2
1 parent 060969b commit 4de0d0a

File tree

1 file changed

+29
-19
lines changed

1 file changed

+29
-19
lines changed

bip-0003.md

Lines changed: 29 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -511,36 +511,46 @@ mentioned in the [Changelog](#changelog) section.
511511

512512
### Changes from BIP 2
513513

514-
- Introduce Deputies and optional Deputies header.
515-
- Rename "Author" field to "Authors".
516-
- Refer to the proposers of a BIP as "authors" throughout the document.
517-
- The Standards Track type is superseded by the similar Specification type.[^standard-track]
518-
- Many sections are declared optional, it is up to the authors and audience to judge whether all relevant topics have
519-
been comprehensively addressed and which topics require a designated section to do so.
520-
- Layer header is optional for Specification BIPs or Informational BIPs, as it does not make sense for all BIPs.[^layer]
521-
- The comment system is abolished. Comments-URI and Comment-Summary headers are dropped from the preamble, Comments as
522-
an aspect of the process are discontinued.[^comments]
523-
- Process BIPs are living documents that do not ossify and may be modified indefinitely.
524-
- Titles may now be up to 50 characters.
525-
- The "Discussions-To" header is dropped as it has never been used in any BIP.
526-
- The "Post-History" header is replaced with the "Discussion" header.
527-
- The "Superseded-By" header is replaced with the "Proposed-Replacement" header.
514+
#### Editor Role
515+
516+
#### Workflow
517+
528518
- Status field values are reduced from nine to four:
529519
- Deferred, Obsolete, Rejected, Replaced, and Withdrawn are gathered up into Closed.[^closed]
530520
- Final and Active are collapsed into Deployed.
521+
- Proposed is renamed to Complete.
531522
- The remaining statuses are Draft, Complete, Deployed, and Closed.
532523
- A BIP in Draft or Complete status may no longer be closed solely on grounds of not making progress for three years.[^rejection]
533524
- A BIP in Draft status may be set to Closed by anyone if it appears to have stopped making progress for at least a
534525
year and its authors do not assert that they are still working on it when contacted.
535-
- Many judgment calls previously required from BIP Editors are reassigned either to the BIP authors or the repository’s
526+
- Process BIPs are living documents that do not ossify and may be modified indefinitely.
527+
- Some judgment calls previously required from BIP Editors are reassigned either to the BIP authors or the repository’s
536528
audience.
537-
- Tracking of adoption, acceptance, and community consensus is out of scope for the BIPs repository, except to determine
538-
whether a BIP is in active use for the move into or out of the Deployed status.
529+
- The comment system is abolished.[^comments]
530+
531+
#### BIP Format
532+
533+
- The Standards Track type is superseded by the similar Specification type.[^standard-track]
534+
- Many sections are declared optional, it is up to the authors and audience to judge whether all relevant topics have
535+
been comprehensively addressed and which topics require a designated section to do so.
539536
- "Other Implementations" sections are discouraged.[^OtherImplementations]
540537
- Auxiliary files are only permitted in the corresponding BIP’s subdirectory, as no one used the alternative of labeling
541538
them with the BIP number.
542-
- The set of acceptable licenses was reduced to the ones previously used and two more requested by reviewers, and the distinction between recommended and
543-
acceptable licenses was dropped.
539+
- Tracking of adoption, acceptance, and community consensus is out of scope for the BIPs repository, except to determine
540+
whether a BIP is in active use for the move into or out of the Deployed status.
541+
- The distinction between recommended and acceptable licenses was dropped.
542+
- Most licenses that have not been used in the BIP process have been dropped from the list of acceptable licenses.
543+
544+
#### Preamble
545+
546+
- Comments-URI and Comment-Summary headers are dropped from the preamble.[^comments]
547+
- The "Superseded-By" header is replaced with the "Proposed-Replacement" header.
548+
- The "Post-History" header is replaced with the "Discussion" header.
549+
- The "Discussions-To" header is dropped as it has never been used in any BIP.
550+
- Introduce Deputies and optional Deputies header.
551+
- Titles may now be up to 50 characters.
552+
- Layer header is optional for Specification BIPs or Informational BIPs, as it does not make sense for all BIPs.[^layer]
553+
- Rename "Author" field to "Authors".
544554

545555
### Updates to Existing BIPs should this BIP be Activated
546556

0 commit comments

Comments
 (0)