Boost logo

Boost-Commit :

From: daniel_james_at_[hidden]
Date: 2007-11-04 16:49:04

Author: danieljames
Date: 2007-11-04 16:49:04 EST (Sun, 04 Nov 2007)
New Revision: 40760

Bring the review process up to date. At least I think it is - this document is
a mess in trunk right now. Fixes #1350.

Text files modified:
   website/public_html/beta/community/reviews.html | 58 +++++++++++++++++++++++++++++++++------
   1 files changed, 49 insertions(+), 9 deletions(-)

Modified: website/public_html/beta/community/reviews.html
--- website/public_html/beta/community/reviews.html (original)
+++ website/public_html/beta/community/reviews.html 2007-11-04 16:49:04 EST (Sun, 04 Nov 2007)
@@ -25,6 +25,15 @@
               <h1>Boost Formal Review Process</h1>
+ <div class="admonition">
+ <h2>Before Requesting a Formal Review</h2>
+ <p><strong>Read and follow the Boost <a href=
+ "submission_process.htm">submission process</a>.</strong> There
+ are at least four steps a library author must take before a
+ formal review is requested.</p>
+ </div>
             <div class="section-body">
               <ul class="toc">
@@ -77,6 +86,15 @@
               identify problems along the way, please note if they are minor,
               serious, or showstoppers.</p>
+ <p>The goal of a Boost library review is to improve the library
+ through constructive criticism, and at the end a decision must
+ be made: is the library good enough at this point to accept
+ into Boost? If not, we hope to have provided enough
+ constructive criticism for it to be improved and accepted at a
+ later time. The Serialization library is a good example of how
+ constructive criticism resulted in revisions resulting in an
+ excellent library that was accepted in its second review.</p>
               <p>Here are some questions you might want to answer in your
@@ -107,6 +125,22 @@
                 comments don't obscure your overall opinion.</li>
+ <p>Many reviews include questions for library authors. Authors
+ are interested in defending their library against your
+ criticisms; otherwise they would not have brought their library
+ up for review. If you don't get a response to your question
+ quickly, be patient; if it takes too long or you don't get an
+ answer you feel is sufficient, ask again or try to rephrase the
+ question. Do remember that English is not the native language
+ for many Boosters, and that can cause misunderstandings.</p>
+ <p>E-mail is a poor communication medium, and even if messages
+ rarely get lost in transmission, they often get drowned in the
+ deluge of other messages. Don't assume that an unanswered
+ message means you're being ignored. Given constructively,
+ criticism will be taken better and have more positive effects,
+ and you'll get the answers you want.</p>
               <h2><a name="Results" id="Results"></a>Results</h2>
               <p>At the conclusion of the comment period, the Review Manager
@@ -168,15 +202,22 @@
                 <li>Follows review discussions regarding the library,
                 moderating or answering questions as needed.</li>
+ <li>Asks the review wizard for
+ permission to extend the review schedule if it appears that
+ too few reviews will be submitted during the review
+ period.</li>
                 <li>Decides if there is consensus to accept the library, and
                 if there are any conditions attached.</li>
- <li>Posts a message on both the <strong><a href=
- "mailto:boost_at_[hidden]">boost</a></strong> and
- <strong><a href=
+ <li>Posts a notice of the <a href="#Results">review
+ results</a> on the regular <strong><a href=
+ "mailto:boost_at_[hidden]">boost</a></strong> mailing
+ list, the <strong><a href=
+ "mailto:boost-users_at_[hidden]">boost-users</a></strong>
+ mailing list, and the <strong><a href=
- lists informing members of the <a href="#Results">review
- results</a>.</li>
+ mailing list.</li>
               <p>In other words, it is the Review Manager's responsibility to
@@ -241,10 +282,9 @@
                 major adjustments.</li>
- <p>The role of Boost Review Wizard is currently played by
- <a href="mailto:reportbase_at_[hidden]" class="external">Tom
- Brinkman</a> and Ronald Garcia (garcia at cs dot indiana dot
- edu).</p>
+ <p>The role of Boost Review Wizard is currently played by John
+ Phillips (phillips at mps dot ohio-state dot edu) and Ronald
+ Garcia (garcia at cs dot indiana dot edu).</p>
               <h2><a name="Fast-Track" id="Fast-Track"></a>Fast Track

Boost-Commit list run by bdawes at, david.abrahams at, gregod at, cpdaniel at, john at