Review Cockpit: Create and Execute a Review
Overview
A review brings together a number of issues and a group of users that will examine them individually to determine whether to accept or reject them. This page explains how Review Cockpit of easeRequirements Ultimate for Jira supports you to create a review, assign moderators and reviewers, and execute the review to conclusion.
User Interface
The user interface of the Review Cockpit consists of the following elements:
An extra section for Review issues named “Review” appears in the issue Detail View of easeRequirements for Jira. The reviewers' subtasks and their status are displayed in this section, as well as buttons to manage the review.
The Review Details View displays the details of a review and a number of quick filters. It contains two panes:
The left pane displays the review issue itself with the reviewers' subtasks, followed by the issues in the scope of the review. The review status of each issue in the scope is provided in terms of the aggregate number of comments, acceptances and rejections, as determined by the reviewers. The cumulative numbers are also provided for the review itself and the reviewer subtasks.
The right pane displays the issue selected in the left pane. If the issue form part of the scope of the review, additional buttons are provided in the upper right corner, allowing the reviewer to set the outcome of the review and page through the reviewers' subtasks.
Operations
Create a review
Action | Explanation |
---|---|
| The recommended place to create a review is in a folder that contains the issues to be reviewed, since when a review is created, its sibling issues and their child issues are automatically added to the scope of the review. Use the filter option to reduce the initial scope for the review creation. Issues can still be added or removed from the scope manually after the review is created. |
| This is the only way to create a review. Simply creating a review issue in Jira itself does not result in an issue that the application recognizes as a review, and the special features of the Review Cockpit will not be available. The “Create review“ option will only appear if the project is associated to a review scheme. |
| The review moderators and reviewers should be selected here if the fields are available in the screen (but they can still be added or removed later if necessary). The new issue contains a section named “Review”, containing a review subtask for each of the specified reviewers. Assuming you have included yourself as a moderator, you will see two buttons: Moderator View and Edit Scope. |
| To manage the review, you need to be a member of the Moderator field. If you did not include yourself in the field when you created the issue, you should do so now. |
| If additional reviewers are needed, you can add them now. A review subtask is automatically created for every user added to the Reviewers field. |
Moderate the review
Action | Explanation |
---|---|
| The status indicates that the review is underway. |
| The Review section shows each reviewer’s subtask including the following information:
|
| This action is only needed if the default scope of the review needs to be modified. Select new issues to be added to the review by its issue key or remove issues not part of the process. |
| This action opens the Review Details view. Monitor the review by checking the status from each of the reviewers' subtasks and the accumulated results from all reviewers. |
| The status indicates that the issues in the scope of the review have been reviewed. |
Execute the review
Action | Explanation |
---|---|
| The status indicates to the moderator that you are working on the review. |
| This action opens the Review Details view for your individual review. |
| On Review Details issue header, there are buttons used to comment and make your decision about the issue:
Additionally, depending on your project permissions, you will see Edit and Workflow status buttons. Lastly, there are icons that enable you to navigate between issues in the left pane. The comments section of an issue marks comments made in the current review and provides an extra filter that limits comments to those made in this review. The review comments can be resolved individually and resolved comments can be reopened if needed. |
| The status indicates that you have completed your work on the review. |