Creation and follow-up of a review

A user with the appropriate role can create a review and add reviewers among project members. Creating a review is done by clicking on the New Review button on the page listing the reviews of the project. A review can be also created from a template. To achieve this, click the toggle icon right of the "New Review" button then click "From review template".

Before being able to fill the review creation form, a configuration must be selected. Indeed, when a review is created, its own global configuration is created as well. A review global configuration can be found in the configuration picker, in the "Review Context" tab, or on the review details page. The review global configuration has no ties with the other global configurations of the project. Hence, the configuration selected in the review creation form serves to initialize the project administration settings to use in the context of the review. This way, the review global configuration does not start empty when opening the project administration pages. The configuration selected in the form is in no way used to assign the review's designs.

A review has a title, key, description, priority [High / Medium / Low], due date, as well as objectives. In addition, it can contain custom attributes, as setup in the project administration.

When creating a review from a template, the title and description of the review and its objectives are preset from the template's values.

Definition of contributors

Once the review has been created, you can list the contributors who will participate in the review:

1. On the Review page General tab, click the Edit button in the Contributors area.
2. Select among the members of the project those who can contribute to the review, or click the toggle to add contributors from a list of e-mails.

Defining review moderators

Once contributors have been added to the review, some of them can be assigned as review moderators. They can be either picked manually from the displayed table, or from a list of e-mails.
Being a review moderator means one can moderate everyone's comments and findings on the review, in compliance with the permission granted to the moderator on the project. For instance, a user can be added to review moderators, despite not having any role with the findings moderation permission. In that case, such a user will be able to moderate the review's comments, but not its findings.
In addition, even if a user has the required permissions to moderate comments and findings on a project, they will only be able to moderate them on reviews where they are assigned as a moderator.

Defining the scope of the review

You can then list the designs to review. For each design, you must tell which version (stream / baseline) is to be reviewed.

Here are the steps to narrow down the list of designs:

1. On the review page General tab, click the Edit button in the Designs area.
2. Select from the project designs those whose resources can be commented on as part of the review.
3. For each design, confirm or, if desired, update the selected configuration.

When the review is started, the data to review is frozen. If a design's configuration is a stream, a snapshot is automatically created, for use in the context of the review. At this point, the review keeps a reference both to the design's configuration that was initially added to the review, and also to the design's snapshot currently in review. This mechanism makes it possible to continue publishing new data on a design stream, without continuously impacting the review.

The "status of the reviewed version" column is illustrated with the icon. The icon indicates that the reviewed data is up to date, whereas the icon indicates that new data has been published on the design stream, and that the review does not include these updates yet.

Defining the objectives of the review

A review is broken down into review objectives. Each review objective is summarized by a title and a description.

Here are the steps to add a review objective:

1. On the review page Objectives tab, click the Add button.
2. On the General tab of the authoring window, give a title and description to the review objective. This information should tell a contributor what actions you expect from them.
3. On the Resources tab, select the primary resources affected by this review objective. The selectable resources are those contained in the designs referenced by the review, or the designs themselves.
4. On the Contributors tab, select the subset of contributors affected by this review objective. Not all review contributors are necessarily involved in each review objective. Reducing the number of contributors to this level makes it possible to assign to each contributor an objective according to their area of competence.

The review objectives can be reordered with the Sort button in the Review Objectives tab.

Monitoring of the review and life cycle

A review has a fixed workflow: [Creation of the review] => Not started => [Start the review] => In Progress => [Finalize the review] => Completed.

Once the review objectives are created, you can start the review by clicking the Start Review button on the toolbar. Contributors can then begin their review work and comment on design resources.

The review page details its progress:

• The Properties area displays the overall progress of the review.
• The Contributors area displays the progress per contributor, allowing you to know who to follow-up with if necessary.
• The Designs area displays the progress per design.
• The Review Objectives tab displays progress per review objective.

The Comments tab on the review page displays all of the comments created by contributors in this review. Comments can be filtered by design, resource, review objective, type, status, creator and custom attributes. Custom attributes that appear on the table can be configured by a user with the appropriate role.

Once the contributors have completed their review, you can close the review by clicking the Close Review button on the toolbar. The review can then be re-opened, if necessary, via the same button.

Generation of a report on the review

Via the Report, button, a report document can be produced on the current review. For more information, see the section Generating a report.

Delete Review

A Delete drop-down menu is available on the review page for users with the appropriate permission. It permanently erases the review AND the comments created as part of this review.

Caution: As deletion is definitive, it is recommended that you use this feature only in rare cases.