summaryrefslogtreecommitdiff
path: root/bip-0002.mediawiki
diff options
context:
space:
mode:
authorLuke Dashjr <luke-jr+git@utopios.org>2016-02-05 00:04:55 +0000
committerLuke Dashjr <luke-jr+git@utopios.org>2016-02-05 00:04:55 +0000
commitd21c27b96efc0072d4884fb321b3b171c340c4ac (patch)
treefcf277fd1833c69327b0390270e9c48805f4f593 /bip-0002.mediawiki
parent5fb9d90d2d2a9d4ce7068087823bcbdaf83949ff (diff)
downloadbips-d21c27b96efc0072d4884fb321b3b171c340c4ac.tar.xz
bip-0002: Clarify that BIP comments are intended for final reviews, not suggestions to drafts
Diffstat (limited to 'bip-0002.mediawiki')
-rw-r--r--bip-0002.mediawiki7
1 files changed, 6 insertions, 1 deletions
diff --git a/bip-0002.mediawiki b/bip-0002.mediawiki
index bf0a768..6690bc2 100644
--- a/bip-0002.mediawiki
+++ b/bip-0002.mediawiki
@@ -92,7 +92,12 @@ 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]. If a BIP is not yet completed, reviewers should plan to review the new version and remove or revise their comments as applicable, updating the timestamp in the review. 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).
+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].
+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 cross-post their review on the comments page, provided they plan to review any new versions and remove or revise their comments as applicable. 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 .