| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138 |
- <html>
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
- <meta name="GENERATOR" content="Microsoft FrontPage 4.0">
- <meta name="ProgId" content="FrontPage.Editor.Document">
- <title>Boost Formal Review Process</title>
- </head>
- <body bgcolor="#FFFFFF" text="#000000">
- <table border="1" bgcolor="#007F7F" cellpadding="2">
- <tr>
- <td bgcolor="#FFFFFF"><img src="../c++boost.gif" alt="c++boost.gif (8819 bytes)" width="277" height="86"></td>
- <td><a href="../index.htm"><font face="Arial" color="#FFFFFF"><big>Home</big></font></a></td>
- <td><a href="../libs/libraries.htm"><font face="Arial" color="#FFFFFF"><big>Libraries</big></font></a></td>
- <td><a href="../people/people.htm"><font face="Arial" color="#FFFFFF"><big>People</big></font></a></td>
- <td><a href="faq.htm"><font face="Arial" color="#FFFFFF"><big>FAQ</big></font></a></td>
- <td><a href="index.htm"><font face="Arial" color="#FFFFFF"><big>More</big></font></a></td>
- </tr>
- </table>
- <h1>Boost Formal Review Process</h1>
- <p>The Formal Review process determines if a proposed library should be accepted
- as a Boost library.</p>
- <p>The final "accept" or "reject" decision is made by the <a href="#Review Manager">
- Review Manager</a>, based on review comments received from boost mailing list
- members.</p>
- <p>Reviews are scheduled so that:</p>
- <ul>
- <li>Each library gets review time proportional to its size, complexity, and
- importance.</li>
- <li>Only a small number of libraries are under active review at any one time.</li>
- <li>Members know ahead of time when a particular library will be under active
- review. </li>
- </ul>
- <h2>Comments</h2>
- <p> Boost mailing list members are encouraged to submit Formal Review
- comments:</p>
- <blockquote>
- <ul>
- <li>Publicly on the mailing list.</li>
- <li>Privately to the Review Manager.</li>
- <li>Privately to the library submitter.</li>
- </ul>
- </blockquote>
- <p>Private comments to a library submitter may be helpful to her or him, but
- won't help the Review Manager reach a decision, so the other forms are
- preferred.</p>
- <h2>Preparing review comments</h2>
- <p>Comments may be brief or lengthy, but basically the Review Manager needs your
- answers to several questions. If you identify problems along the way,
- please note if they are minor, serious, or showstoppers.</p>
- <ul>
- <li>What is your evaluation of the design?<br>
- </li>
- <li>What is your evaluation of the implementation?<br>
- </li>
- <li>What is your evaluation of the documentation?<br>
- </li>
- <li>What is your evaluation of the potential usefulness of the library?<br>
- </li>
- <li>Did you try to use the library? With what compiler? Did you
- have any problems?<br>
- </li>
- <li>How much effort did you put into your evaluation? A glance? A quick
- reading? In-depth study?<br>
- </li>
- <li>Are you knowledgeable about the problem domain?<br>
- </li>
- <li>Finally, do you think the library should be accepted as a Boost
- library? Be sure to say this explicitly so that your other comments
- don't obscure your overall opinion.</li>
- </ul>
- <h2>Results</h2>
- <p>At the conclusion of the comment period, the Review Manager will post a
- message to the mailing list saying if the library has been accepted or
- rejected. A rationale should be provided, but its extent is up to the
- Review Manager.</p>
- <h2>Notes for <a name="Review Manager"> Review Manager</a>s</h2>
- <p>Before a library can be scheduled for formal review, an active boost member not
- connected with the library submission must volunteer to be the "Review
- Manager" for the library.</p>
- <p>The review manager:</p>
- <ul>
- <li>Checks the submission to make sure it really is complete enough to warrant
- formal review. See the <a href="lib_guide.htm">Boost Library
- Requirements and Guidelines</a>. If necessary, work with the submitter
- to verify the code compiles and runs correctly on several compilers and
- platforms.</li>
- <li>Sets the schedule, after discussion with the boost webmaster, currently
- Beman Dawes.</li>
- <li>Posts a notice of the review schedule on both the regular <b> boost mailing
- list</b> and the <b> boost-announce mailing list</b>.</li>
- </ul>
- <blockquote>
- <blockquote>
- <p>The notice should include a brief description of the library and what it
- does, to let readers know if the library is one they are interested in
- reviewing.</p>
- </blockquote>
- </blockquote>
- <ul>
- <li>Inspects the Boost <a href="../libs/libraries.htm">library catalogue</a> for
- libraries which may interact with the new submission. These potential
- interactions should be pointed out in the review announcement, and the
- author(s) of these libraries should be privately notified and urged to
- participate in the review.
- <li>Urges people to do reviews if they aren't forthcoming.</li>
- <li>Follows review discussions regarding the library, moderating or answering
- questions as needed.</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 <b>boost</b> and <b>boost-announce</b> lists informing members of the review
- results.</li>
- </ul>
- <p>In other words, it is the Review Manager's responsibility to make sure the
- review process works smoothly.</p>
- <h2>Notes for Library Authors</h2>
- <p>A proposed library should remain stable during the review period; it will just
- confuse and irritate reviewers if there are numerous changes. It
- is, however, useful to upload fixes for serious bugs right away, particularly
- those which prevent reviewers from fully evaluating the library. Post a
- notice of such fixes on the mailing list.</p>
- <p>Library improvements suggested by reviewers should be held until after the
- completion of review period. Such changes can then be incorporated in the <a href="submission_process.htm#Final">final
- submission file</a> sent to the webmaster for posting. If the suggested
- changes might affect reviewer's judgments, post a notice of the pending
- change on the mailing list.</p>
- <hr>
- <p>Revised <!--webbot bot="Timestamp" s-type="EDITED" s-format="%d %B, %Y" startspan -->11 October, 2001<!--webbot bot="Timestamp" endspan i-checksum="38292" --></p>
- <p> </p>
- </body>
- </html>
|