@@ -112,14 +112,14 @@ appear in the following order. Headers marked with "\*" are optional. All other
112112##### Overview
113113
114114```
115- BIP: <BIP number, or "?">
115+ BIP: <BIP number, or "?" before assignment >
116116* Layer: <Consensus (soft fork) | Consensus (hard fork) | Peer Services | API/RPC | Applications>
117117 Title: <BIP title (≤ 50 characters)>
118118 Authors: <Authors’ names and email addresses>
119119* Deputies: <Deputies’ names and email addresses>
120120 Status: <Draft | Complete | Deployed | Closed>
121121 Type: <Specification | Informational | Process>
122- Created : <Date of number assignment (yyyy-mm-dd), or "?">
122+ Assigned : <Date of number assignment (yyyy-mm-dd), or "?" before assignment >
123123 License: <SPDX License Expression>
124124* Discussion: <Noteworthy discussion threads in "yyyy-mm-dd: URL" format>
125125* Version: <MAJOR.MINOR.PATCH>
@@ -130,7 +130,7 @@ appear in the following order. Headers marked with "\*" are optional. All other
130130
131131##### Header Descriptions
132132
133- * BIP — The assigned number of the BIP. Please use "?" before a number has been assigned by the BIP Editors.
133+ * BIP — The assigned number of the BIP (without leading zeros) . Please use "?" before a number has been assigned by the BIP Editors.
134134* Layer — The layer of Bitcoin the BIP applies to using the BIP classification defined in [ BIP 123] ( bip-0123.mediawiki ) .
135135* Authors — The names (or pseudonyms) and email addresses of all authors of the BIP. The format of each authors header
136136 value must be
@@ -146,6 +146,7 @@ appear in the following order. Headers marked with "\*" are optional. All other
146146 Authors header. See the [ BIP Ownership] ( #bip-ownership ) section above.
147147* Status — The stage of the workflow of the proposal. See the [ Workflow] ( #workflow ) section below.
148148* Type — See the [ BIP Types] ( #bip-types ) section below for a description of the three BIP types.
149+ * Assigned – The date a BIP was assigned its number. Please use "?" before a number has been assigned by the BIP Editors.
149150* License — The License header specifies SPDX License Expressions describing the terms under which the
150151 BIP and its auxiliary files are available. See the [ BIP Licensing] ( #bip-licensing ) section below.
151152* Discussion — The Discussion header points the audience to relevant discussions of the BIP, e.g., the mailing list
@@ -543,8 +544,9 @@ mentioned in the [Changelog](#changelog) section.
543544- The "Superseded-By" header is replaced with the "Proposed-Replacement" header.
544545- The "Post-History" header is replaced with the "Discussion" header.
545546- The optional "Version" header is introduced.
546- - The "Discussions-To" header is dropped as it has never been used in any BIP.
547+ - The "Discussions-To" header is dropped, as it has never been used in any BIP.
547548- The "License-Code" header has been sunset, as it was used by only five BIPs (98, 116, 117, 330, 340) and created more ambiguity than clarity.
549+ - The "Created" header is renamed to "Assigned", as the header’s value is the date of number assignment.[ ^ assigned ]
548550- Introduce Deputies and optional "Deputies" header.
549551- The BIP "Title" header may now contain up to 50 characters (increased from 44 in BIP 2).
550552- The "Layer" header is optional for Specification BIPs or Informational BIPs, as it does not make sense for all BIPs.[ ^ layer ]
@@ -613,6 +615,12 @@ feedback, and helpful comments.
613615
614616## Rationale
615617
618+ [ ^ assigned ] : ** Why was the Created header renamed to Assigned?**
619+ Both BIP 1 and BIP 2 described the Created header as "date created on" in the preamble template, but followed that
620+ up with "Created header records the date that the BIP was assigned a number" as the description of the field. This
621+ has frequently led to confusion, with authors using the date of opening the pull request, the date they started
622+ writing their proposal, the date of number assignment (as prescribed), or various other dates. Aligning the name of
623+ the header and the text in the preamble template with the descriptions will reduce the confusion.
616624[ ^ capitalization ] : ** When is Bitcoin capitalized and when is it lowercased?**
617625 This document uses capitalized Bitcoin to refer to the system, network and abstract concept, and only uses lowercase
618626 bitcoin to refer to units of the bitcoin currency.
0 commit comments