ViewArticle

This section describes a typical review and its phases.

Review Creation

Any of the following actions will create a review:

Once a review is created it goes into the Planning phase.

Planning Phase

In the Planning phase, only the review creator is active to customize the review using the Review Creation Wizard. Here the creator enters review attributes including the title, custom fields, attaches review materials, and assigns participants to the review.

Using the "Begin Review" and "Annotate Review" buttons of the Next Steps section, you can save your current information and move the review to another phase.

Annotating Phase

The Annotating phase is an optional phase that an author may select before the Inspection begins. It provides the opportunity for other participants to add comments, review materials or open defects prior to the Inspection phase. When a review is moved to Annotating, Collaborator will send notifications to all selected participants inviting them to participate in the review. Like Planning, Collaborator will not automatically move the review from the Annotating phase.

The Next Steps section includes a "Begin Review" button for moving the review to the Inspection phase.

Inspection Phase

Once the review has begun, Collaborator activates all roles and notifies the participants that their actions are required in the review. Participants are presented with the files, file-differences, and other review material. Everyone can make comments on individual lines of a file or on entire documents.

Comments work a bit like "instant message" chat and a bit like "newsgroups". If everyone is chatting at the same time, you have a real-time "instant message" environment so the review can progress swiftly. If one or more participants are separated by many time zones or just are not currently at the computer, the chat looks like a newsgroup where you post comments and receive e-mails when someone responds. This means Collaborator works equally well no matter where your developers or reviewers are located.

If reviewers find problems, they open defects right from the Web Client, associated with the file and line number if applicable. Defects are tracked through Collaborator and can optionally be mirrored into an external issue-tracking system.

Once all required participants have indicated that they are finished with the current phase, the review moves to the next phase, which will depend on whether open defects remain in the review.

If there are no defects or all defects have been marked external or fixed, the review moves to the Completed phase.

If the review contains any open defects, the review moves on to the Rework phase.

Rework or Fix Defects Phase

In the Rework phase, the authors are the only roles active so that they may fix the defects found in the Inspection phase. When the authors are satisfied with their fixes, the fixes are uploaded into the review. The authors then indicate they are ready for the fixes to be validated by clicking the "Send to Inspection" button.

For validation, the review moves back to the Inspection phase, where reviewers have access to the new changes as well as the original changes and comments.

Completed Phase

Only when no open defects remain and all required participants have approved the review during inspection, then the review goes to the Completed phase.

Cancelled Phase

Depending on the Allow Deleting/Cancelling Reviews administrative setting, there may be an option for the author or creator to cancel a review. In this case, the "Delete" or "Cancel" button become enabled on the top right of the "General Information" box:

Clicking the "Delete" button removes the review from the database. You can only delete a review that is in the Planning phase. A deleted review can never be restored.

Clicking the "Cancel" button moves the review to the Cancelled phase. A cancelled review can only be re-activated by an administrator.

Rejected Phase

Depending on the Allow Reject Review administrative setting, there may be an option for reviewers to reject a review. In this case, the "Reject" button becomes enabled on the top right of the "General Information" box:

Clicking the "Reject" button invokes a dialog where you can specify reject reason and then moves the review to the Rejected phase. A rejected review cannot be re-opened by anyone, even by an administrator.