summaryrefslogtreecommitdiff
path: root/bip-0002.mediawiki
diff options
context:
space:
mode:
authorLuke Dashjr <luke-jr+git@utopios.org>2016-09-24 03:59:16 +0000
committerLuke Dashjr <luke-jr+git@utopios.org>2016-09-24 06:27:08 +0000
commitdb70f458c81946064f580061bb2c9dd0af13a425 (patch)
tree72618b85ef56f004e2950f5535d2919c17e8ed9d /bip-0002.mediawiki
parentc864f641fa4e7a7f1f048d8b7546647b327c3b89 (diff)
downloadbips-db70f458c81946064f580061bb2c9dd0af13a425.tar.xz
bip-0002: Reduce unnecessary duplication in summary of BIP parts
Diffstat (limited to 'bip-0002.mediawiki')
-rw-r--r--bip-0002.mediawiki20
1 files changed, 8 insertions, 12 deletions
diff --git a/bip-0002.mediawiki b/bip-0002.mediawiki
index 2fecad4..4fed039 100644
--- a/bip-0002.mediawiki
+++ b/bip-0002.mediawiki
@@ -116,25 +116,21 @@ BIPs should be written in mediawiki format.
Each BIP should have the following parts:
-* Preamble -- RFC 822 style headers containing meta-data about the BIP, including the BIP number, a short descriptive title (limited to a maximum of 44 characters), the names, and optionally the contact info for each author, etc.
+* Preamble -- Headers containing metadata about the BIP ([[#Preamble|see below]]).
-* Abstract -- a short (~200 word) description of the technical issue being addressed.
+* Abstract -- A short (~200 word) description of the technical issue being addressed.
-* Copyright/public domain -- Each BIP must either be explicitly labelled as placed in the public domain (see this BIP as an example) or licensed under the Open Publication License.
+* Copyright -- The BIP must be explicitly licensed under acceptable copyright terms ([[#TODO|see below]]).
-* Specification -- The technical specification should describe the syntax and semantics of any new feature. The specification should be detailed enough to allow competing, interoperable implementations for any of the current Bitcoin platforms (Satoshi, BitcoinJ, bitcoin-js, libbitcoin).
+* Specification -- The technical specification should describe the syntax and semantics of any new feature. The specification should be detailed enough to allow competing, interoperable implementations for any of the current Bitcoin platforms.
-* Motivation -- The motivation is critical for BIPs that want to change the Bitcoin protocol. It should clearly explain why the existing protocol specification is inadequate to address the problem that the BIP solves. BIP submissions without sufficient motivation may be rejected outright.
+* Motivation -- The motivation is critical for BIPs that want to change the Bitcoin protocol. It should clearly explain why the existing protocol is inadequate to address the problem that the BIP solves.
-* Rationale -- The rationale fleshes out the specification by describing what motivated the design and why particular design decisions were made. It should describe alternate designs that were considered and related work, e.g. how the feature is supported in other languages.
+* Rationale -- The rationale fleshes out the specification by describing what motivated the design and why particular design decisions were made. It should describe alternate designs that were considered and related work. The rationale should provide evidence of consensus within the community and discuss important objections or concerns raised during discussion.
-* The rationale should provide evidence of consensus within the community and discuss important objections or concerns raised during discussion.
+* Backwards compatibility -- All BIPs that introduce backwards incompatibilities must include a section describing these incompatibilities and their severity. The BIP must explain how the author proposes to deal with these incompatibilities.
-* Backwards Compatibility -- All BIPs that introduce backwards incompatibilities must include a section describing these incompatibilities and their severity. The BIP must explain how the author proposes to deal with these incompatibilities. BIP submissions without a sufficient backwards compatibility treatise may be rejected outright.
-
-* Reference Implementation -- The reference implementation must be completed before any BIP is given status "Final", but it need not be completed before the BIP is accepted. It is better to finish the specification and rationale first and reach consensus on it before writing code.
-
-* The final implementation must include test code and documentation appropriate for the Bitcoin protocol.
+* Reference implementation -- The reference implementation must be completed before any BIP is given status "Final", but it need not be completed before the BIP is accepted. It is better to finish the specification and rationale first and reach consensus on it before writing code. The final implementation must include test code and documentation appropriate for the Bitcoin protocol.
====BIP header preamble====