summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorLuke Dashjr <luke-jr+git@utopios.org>2016-09-24 02:48:30 +0000
committerLuke Dashjr <luke-jr+git@utopios.org>2016-09-24 02:48:30 +0000
commit9f0ef24770f9286f6753c881edc3f6609398dc33 (patch)
treeaf25b08533a4a16f77ba8c3a734a2baf8bf77114
parent3b4421b7886662e4c97fe6f2bd5d2ac0db362529 (diff)
downloadbips-9f0ef24770f9286f6753c881edc3f6609398dc33.tar.xz
bip-0002: Move BIP Comments to GitHub bitcoin/bips wiki
-rw-r--r--bip-0002.mediawiki22
1 files changed, 14 insertions, 8 deletions
diff --git a/bip-0002.mediawiki b/bip-0002.mediawiki
index c5274c0..5704405 100644
--- a/bip-0002.mediawiki
+++ b/bip-0002.mediawiki
@@ -102,18 +102,25 @@ What if a BIP is proposed that only makes sense for a single specific project?
===Specification===
-Each BIP should, in its preamble, link to a Bitcoin Wiki page with a summary tone of the comments on that page.
-Reviewers of the BIP who consider themselves qualified, should post their own comments on this wiki page in [https://www.mediawiki.org/wiki/Help:Talk_pages#Editing_conventions_on_talk_pages standard "Talk page" format].
+Each BIP should, in its preamble, link to a public wiki page with a summary tone of the comments on that page.
+Reviewers of the BIP who consider themselves qualified, should post their own comments on this wiki page.
The comments page should generally only be used to post final comments for a completed BIP.
If a BIP is not yet completed, reviewers should instead post on the applicable development mailing list thread to allow the BIP author(s) to address any concerns or problems pointed out by the review.
Some BIPs receive exposure outside the development community prior to completion, and other BIPs might not be completed at all. To avoid a situation where critical BIP reviews may go unnoticed during this period, reviewers may, at their option, still post their review on the comments page, provided they first post it to the mailing list and plan to later remove or revise it as applicable based on the completed version. Such revisions should be made by editing the previous review and updating the timestamp. Reviews made prior to the complete version may be removed if they are no longer applicable and have not been updated in a timely manner (eg, within one month).
-Pages must be named after the full BIP number (eg, "BIP 0001") and placed in the "BIP Comments" namespace. For example, the link for BIP 1 will be https://en.bitcoin.it/wiki/BIP_Comments:BIP_0001 .
+Pages must be named after the full BIP number (eg, "BIP 0001") and placed in the "Comments" namespace.
+For example, the link for BIP 1 will be https://github.com/bitcoin/bips/wiki/Comments:BIP-0001 .
-In order to avoid possible abuse of Bitcoin Wiki moderation, BIPs may choose to list a second forum for BIP comments, in addition to the Bitcoin Wiki. In this case, the second forum's URI should be listed below the Bitcoin Wiki's URI.
+Comments posted to this wiki should use the following format:
-Summary tones may be chosen from the following, but this BIP does not intend to cover all possible nuances:
+ <Your opinion> --<Your name>, <Date of posting, as YYYY-MM-DD>
+
+BIPs may also choose to list a second forum for BIP comments, in addition to the BIPs wiki.
+In this case, the second forum's URI should be listed below the primary wiki's URI.
+
+After some time, the BIP itself may be updated with a summary tone of the comments.
+Summary tones may be chosen from the following, but this BIP does not intend to cover all possible nuances and other summaries may be used as needed:
* No comments yet.
* Unanimously Recommended for implementation
@@ -124,7 +131,7 @@ Summary tones may be chosen from the following, but this BIP does not intend to
For example, the preamble to BIP 1 might be updated to include the line:
Comments-Summary: No comments yet.
- Comments-URI: https://en.bitcoin.it/wiki/BIP_Comments:BIP_0001
+ Comments-URI: https://github.com/bitcoin/bips/wiki/Comments:BIP-0001
https://some-other-wiki.org/BIP_1_Comments
These fields must follow the "Discussions-To" header defined in BIP 1 (if that header is not present, it should follow the position where it would be present; generally this is immediately above the Status header).
@@ -139,8 +146,7 @@ What is the purpose of BIP comments?
Will BIP comments be censored or limited to particular participants/"experts"?
-* The Bitcoin Wiki moderators have control over that venue and may make reasonable moderation attempts. Admitted non-experts should refrain from commenting outside of their area of knowledge. However, comments should not be censored, and participation should be open to the public.
-* If the Bitcoin Wiki were to abuse its position, the venue for comments can always be changed.
+* Participants should freely refrain from commenting outside of their area of knowledge or expertise. However, comments should not be censored, and participation should be open to the public.
==BIP licensing==