diff --git a/bugs.htm b/bugs.htm index bb85a8d..6d07c54 100644 --- a/bugs.htm +++ b/bugs.htm @@ -45,8 +45,8 @@
  • Submit a bug report to either boost-users list, boost mailing - list, or our bug - tracking facility at SourceForge; submitting it to either of the mailing + list, or our bug + tracking facility; submitting it to either of the mailing lists is a preferred way - because many of the Boost developers read the lists on a daily basis, this way you are likely to get a quicker response, and the discussions that often arise there from (possible) bug reports are diff --git a/formal_review_process.htm b/formal_review_process.htm index 6c7fac3..ca9ae11 100644 --- a/formal_review_process.htm +++ b/formal_review_process.htm @@ -9,73 +9,103 @@ - Boost Formal Review Process - + Boost Formal Review Process + + - - - - + +
    -
    + + - + - + - + - + - - -
    +HomeHomeLibrariesLibrariesPeoplePeopleFAQFAQMore
    + More + + -

    Boost Formal Review Process

    +

    Boost Formal Review Process

    +
    +

    Before Requesting a Formal Review

    +

    Read and follow the Boost submission process.  There are at + least four steps a library author must take before a formal review is + requested.

    +
    -

    Introduction
    - What to include in Review Comments
    - Results
    - Notes for Review Managers
    - Notes for Library Submitters
    - Review Wizard
    - Fast Track Reviews

    +

    Introduction
    + What to include in Review Comments
    + Results
    + Notes for Review Managers
    + Notes for Library Submitters
    + Review Wizard
    + Fast Track Reviews

    -

    Introduction

    +

    Introduction

    -

    Proposed libraries are accepted into Boost only after undergoing a - formal review, where Boost mailing list members comment on their - evaluation of the library.

    +

    Proposed libraries are accepted into Boost only after undergoing a + formal review, where Boost mailing list members comment on their evaluation + of the library.

    -

    The final "accept" or "reject" decision is made by the Review Manager, based on the review comments - received from boost mailing list members.

    +

    The final "accept" or "reject" decision is made by the Review Manager, based on the review comments received + from boost mailing list members.

    -

    Boost mailing list members are encouraged to submit Formal Review - comments:

    +

    Boost mailing list members are encouraged to submit Formal Review + comments:

    -
    - +
    -

    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.

    +

    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.

    -

    What to include in Review Comments

    +

    What to include in Review Comments

    -

    Your comments may be brief or lengthy, but basically the Review - Manager needs your evaluation of the library.  If you identify - problems along the way, please note if they are minor, serious, or - showstoppers.

    +

    Your comments may be brief or lengthy, but basically the Review Manager + needs your evaluation of the library.  If you identify problems along + the way, please note if they are minor, serious, or showstoppers.

    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 @@ -87,39 +117,32 @@

    Here are some questions you might want to answer in your review:

    - -

    And finally, every review should answer this question:
    -

    +

    And finally, every review should answer this question:

    - +

    Many reviews include questions for library authors. Authors are interested in defending their library against your criticisms; otherwise @@ -137,60 +160,59 @@

    Results

    -

    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 is also helpful, but its extent is up to the - Review Manager. If there are suggestions, or conditions that must be met - before final inclusion, they should be stated.

    +

    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 is also helpful, but its extent is up to the + Review Manager. If there are suggestions, or conditions that must be met + before final inclusion, they should be stated.

    -

    Notes for Review Managers

    +

    Notes for Review + Managers

    -

    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.

    +

    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.

    -

    The Review Manager:

    +

    The Review Manager:

    - -

    Notes for Library Submitters

    +

    In other words, it is the Review Manager's responsibility to make sure + the review process works smoothly.

    -

    See Submission Process for a - description of the steps a library developer goes through to get a - library accepted by Boost.

    +

    Notes for Library Submitters

    -

    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.

    +

    See Submission Process for a + description of the steps a library developer goes through to get a library + accepted by Boost.

    -

    Library improvements suggested by reviewers should normally be held - until after the completion of review period.  If the suggested - changes might affect reviewer's judgments, post a notice of the - pending change on the mailing list.

    +

    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.

    -

    Review Wizard

    +

    Library improvements suggested by reviewers should normally be held + until after the completion of review period.  If the suggested changes + might affect reviewer's judgments, post a notice of the pending change + on the mailing list.

    -

    The Review Wizard coordinates the formal review schedule:

    +

    Review Wizard

    -