bitcoin/bips
1
0
Fork 0
mirror of https://github.com/bitcoin/bips.git synced 2025-09-29 13:52:41 +00:00
Code Issues Releases Wiki Activity

Merge pull request #1970 from murchandamus/2025-09-assigned-header

Browse Source 
BIP3: Rename Created to Assigned
This commit is contained in:
Jon Atack 2025-09-19 16:31:04 -07:00 committed by GitHub
commit 87f3fe1644
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 12 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
bip-0003.md
View File

@ -112,14 +112,14 @@ appear in the following order. Headers marked with "\*" are optional. All other
##### Overview ##### Overview
``` ```
BIP: <BIP number, or "?"> BIP: <BIP number, or "?" before assignment>
* Layer: <Consensus (soft fork) | Consensus (hard fork) | Peer Services | API/RPC | Applications> * Layer: <Consensus (soft fork) | Consensus (hard fork) | Peer Services | API/RPC | Applications>
Title: <BIP title (≤ 50 characters)> Title: <BIP title (≤ 50 characters)>
Authors: <Authors’ names and email addresses> Authors: <Authors’ names and email addresses>
* Deputies: <Deputies’ names and email addresses> * Deputies: <Deputies’ names and email addresses>
Status: <Draft | Complete | Deployed | Closed> Status: <Draft | Complete | Deployed | Closed>
Type: <Specification | Informational | Process> Type: <Specification | Informational | Process>
Created: <Date of number assignment (yyyy-mm-dd), or "?"> Assigned: <Date of number assignment (yyyy-mm-dd), or "?" before assignment>
License: <SPDX License Expression> License: <SPDX License Expression>
* Discussion: <Noteworthy discussion threads in "yyyy-mm-dd: URL" format> * Discussion: <Noteworthy discussion threads in "yyyy-mm-dd: URL" format>
* Version: <MAJOR.MINOR.PATCH> * Version: <MAJOR.MINOR.PATCH>
@ -130,7 +130,7 @@ appear in the following order. Headers marked with "\*" are optional. All other
##### Header Descriptions ##### Header Descriptions
* BIP — The assigned number of the BIP. Please use "?" before a number has been assigned by the BIP Editors. * BIP — The assigned number of the BIP (without leading zeros). Please use "?" before a number has been assigned by the BIP Editors.
* Layer — The layer of Bitcoin the BIP applies to using the BIP classification defined in [BIP 123](bip-0123.mediawiki). * Layer — The layer of Bitcoin the BIP applies to using the BIP classification defined in [BIP 123](bip-0123.mediawiki).
* Authors — The names (or pseudonyms) and email addresses of all authors of the BIP. The format of each authors header * Authors — The names (or pseudonyms) and email addresses of all authors of the BIP. The format of each authors header
value must be value must be
@ -146,6 +146,7 @@ appear in the following order. Headers marked with "\*" are optional. All other
Authors header. See the [BIP Ownership](#bip-ownership) section above. Authors header. See the [BIP Ownership](#bip-ownership) section above.
* Status — The stage of the workflow of the proposal. See the [Workflow](#workflow) section below. * Status — The stage of the workflow of the proposal. See the [Workflow](#workflow) section below.
* Type — See the [BIP Types](#bip-types) section below for a description of the three BIP types. * Type — See the [BIP Types](#bip-types) section below for a description of the three BIP types.
* Assigned – The date a BIP was assigned its number. Please use "?" before a number has been assigned by the BIP Editors.
* License — The License header specifies SPDX License Expressions describing the terms under which the * License — The License header specifies SPDX License Expressions describing the terms under which the
BIP and its auxiliary files are available. See the [BIP Licensing](#bip-licensing) section below. BIP and its auxiliary files are available. See the [BIP Licensing](#bip-licensing) section below.
* Discussion — The Discussion header points the audience to relevant discussions of the BIP, e.g., the mailing list * 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.
- The "Superseded-By" header is replaced with the "Proposed-Replacement" header. - The "Superseded-By" header is replaced with the "Proposed-Replacement" header.
- The "Post-History" header is replaced with the "Discussion" header. - The "Post-History" header is replaced with the "Discussion" header.
- The optional "Version" header is introduced. - The optional "Version" header is introduced.
- The "Discussions-To" header is dropped as it has never been used in any BIP. - The "Discussions-To" header is dropped, as it has never been used in any BIP.
- 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. - 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.
- The "Created" header is renamed to "Assigned", as the header’s value is the date of number assignment.[^assigned]
- Introduce Deputies and optional "Deputies" header. - Introduce Deputies and optional "Deputies" header.
- The BIP "Title" header may now contain up to 50 characters (increased from 44 in BIP 2). - The BIP "Title" header may now contain up to 50 characters (increased from 44 in BIP 2).
- The "Layer" header is optional for Specification BIPs or Informational BIPs, as it does not make sense for all BIPs.[^layer] - 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.
## Rationale ## Rationale
[^assigned]: **Why was the Created header renamed to Assigned?**
Both BIP 1 and BIP 2 described the Created header as "date created on" in the preamble template, but followed that
up with "Created header records the date that the BIP was assigned a number" as the description of the field. This
has frequently led to confusion, with authors using the date of opening the pull request, the date they started
writing their proposal, the date of number assignment (as prescribed), or various other dates. Aligning the name of
the header and the text in the preamble template with the descriptions will reduce the confusion.
[^capitalization]: **When is Bitcoin capitalized and when is it lowercased?** [^capitalization]: **When is Bitcoin capitalized and when is it lowercased?**
This document uses capitalized Bitcoin to refer to the system, network and abstract concept, and only uses lowercase This document uses capitalized Bitcoin to refer to the system, network and abstract concept, and only uses lowercase
bitcoin to refer to units of the bitcoin currency. bitcoin to refer to units of the bitcoin currency.