# Peer reviews

**Peer Reviews** provide the opportunity for collaborative Requirement evaluation. Users can initiate structured reviews by selecting Requirements for feedback and inviting participants. Reviewers can then provide comments and collaborate with the Review Creator. Comments remain within the review and do not alter the original requirements. Reviewers can submit feedback and continue commenting until the review is officially closed.

### Initiate a Peer Review

1. Select requirement(s) to review. Right click and choose **Send to Peer Review**.

<div data-with-frame="true"><figure><img src="https://2091741164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrraExym8pNEUvBDoima%2Fuploads%2FwJri2g2dzqG1R0nnuFjO%2Fimage.png?alt=media&#x26;token=90e9f301-98f9-4459-a06d-9b57a7cea18e" alt="" width="375"><figcaption></figcaption></figure></div>

2. Set up the review request from the **Peer Review** window.

   * Add a descriptive message for the reviewers.
   * Under **Requirements** you can select or unselect Requirements for review.
   * Select the individuals or user groups to invite to the peer review.&#x20;
     * Users already assigned as Requirement Approvers are included by default, but can be removed
     * The full list of possible reviewers is based on permissions set for the Requirements in the Team Members field for the [programs](https://docs.violetlabs.com/features/programs "mention"). (See: **Tools - Program - View and Edit Program**.)

   <div data-with-frame="true"><figure><img src="https://2091741164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrraExym8pNEUvBDoima%2Fuploads%2FVAUXvckK2ZisK5KeTzCw%2Fimage.png?alt=media&#x26;token=c3adf2fd-26ac-4a18-b305-0bbaf9d7a9c3" alt="" width="375"><figcaption></figcaption></figure></div>
3. Click Send **Review Request**. This will send an automated email to the selected reviewers with a link to the Peer Review.
4. A green **Peer Review Request Created** notification will appear in the top right corner of the window. Click the **Go to Review** to navigate to the Review Page for the newly created Peer Review.&#x20;

   <div align="left" data-full-width="true" data-with-frame="true"><figure><img src="https://2091741164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrraExym8pNEUvBDoima%2Fuploads%2FZsWLl5iZZbO4MdCLCgJH%2Fimage.png?alt=media&#x26;token=2cff44ef-8ebb-4767-8986-582bd1f18420" alt="" width="283"><figcaption></figcaption></figure></div>

Requirements that are part of an active peer review are labeled:

<figure><img src="https://2091741164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrraExym8pNEUvBDoima%2Fuploads%2FxBZutdhNcfhj9z8ZB5vV%2Fimage.png?alt=media&#x26;token=0a8247ab-9e49-4234-8069-f1778fb92f0a" alt="" width="375"><figcaption></figcaption></figure>

### Navigate to open reviews

After a review is created, a drop-down menu will appear in the upper right of the panel where you can select from the open reviews. A short description of the review message, the Review Creator, and participants are listed.

<figure><img src="https://2091741164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrraExym8pNEUvBDoima%2Fuploads%2F3stDyQD5QW8Nekcybx4T%2Fimage.png?alt=media&#x26;token=00857a76-d856-4046-b907-9f7cb1d938eb" alt="" width="375"><figcaption></figcaption></figure>

### Manage reviews

The "Go to Review" link and Peer Review menu takes the Peer Review creator to the Peer Review page. From here you can monitor the status of the peer review process, add comments, reply to reviewer comments and close the review.&#x20;

* Everyone who has been invited to review the requirement(s) will be visible in the top left corner. Hover over a user icon to see the status of their review.

<figure><img src="https://2091741164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrraExym8pNEUvBDoima%2Fuploads%2FJ0DvJrEQOx29lptj4xzx%2Fimage.png?alt=media&#x26;token=bf379ccf-902e-4618-9a29-bde918c709ed" alt="" width="193"><figcaption></figcaption></figure>

* In the **Comments** section on the right side of the window, the review originator can review participants' review comments, create a new comment, edit/delete comments and mark a comment as resolved.
  * Use **Show Resolved Comment toggle** to hide or display resolved comments.
  * Standard commenting features apply (ex: Tag users with "@username" to notify them about your question).
* Click **Close Review** when Peer Review is completed.&#x20;
  * Users are not required to close out collected comments for the peer review to be closed.

Note, if you make updates to a requirement that's undergoing a review, the new version is immediately available to review participants as they occur.&#x20;

### Receive and complete reviews

Participant reviewers can navigate to the Peer Review page using the link in their review invitation email, where they can then:

1. Review requirements
   1. Use the **Only My Requirements** toggle to display only the requirements for which you are an approver/owner or that you have created.
2. Add, view, reply to [Comments](https://docs.violetlabs.com/features/getting-started#commenting-on-requirements)
   * Comments are accessible on the right side of the Review page and **are only accessible in the Peer Review and not in the requirements themselves.**

Click **Finish Review** button in the top right corner of the screen to close out Peer Review.

1. This opens the **Submit Peer Review** window where you can summarize your actions and share any larger feedback.&#x20;

<figure><img src="https://2091741164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrraExym8pNEUvBDoima%2Fuploads%2FtOvGmyJhEkHYiiACTrpe%2Fimage.png?alt=media&#x26;token=76c8b309-9ab1-4b1c-a40b-446c86dbbbd9" alt="" width="375"><figcaption></figcaption></figure>

* Once submitted your peer review status will change from **Pending** to **Complete**.

{% hint style="success" %}
Note: Even after submission, participants can still view other comments and add new ones while the review remains open.
{% endhint %}

### Review timeline

View a timeline of review notes and review submissions by participants, including their comments on the requirements.

<div data-with-frame="true"><figure><img src="https://2091741164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrraExym8pNEUvBDoima%2Fuploads%2FUaxa4Dm5cDlwVZkyJKEf%2Fimage.png?alt=media&#x26;token=4f208185-e67f-4a6f-b993-b880f34b626f" alt="" width="375"><figcaption></figcaption></figure></div>