Choosing reviewers

This page describes how to add reviewers to a new review, after it has been created.
See Creating a review for information about creating reviews.

On this page:

Entering basic information

Once a review has been created, the Edit Review dialog opens: 



In the Edit Review dialog, the author enters information needed for the review. This includes entering a title and description for the review, a due date and the key for a related JIRA issue (if any). The project, moderator and author are pre-selected (for this example, the author should select himself as a moderator).

You must also select reviewers, described next.

Adding and removing reviewers

Before a review can be started, you need to choose reviewers. When adding reviewers, you can add Crucible users immediately.

Adding users to a review

Choose reviewers from the available Crucible users by typing names into the Reviewers field. The users who are available to be reviewers is determined by the project's settings for Default Reviewers – see Creating a project.

Click Done to save the review as a draft for later issue.

You can also allow any Crucible user to add themselves as a reviewer by selecting Allow anyone to join.

Suggested reviewers

Crucible will automatically suggest reviewers, by analysing the users that have contributed to the files you've selected and also don't have a lot of open reviews. You can easily pick reviewers from the list of suggestions by clicking.

Removing reviewers

You can remove reviewers who no longer need to contribute to the review.

Click Edit Details to open the 'Edit Review Details' screen, hover over the reviewer's name, and click the cross.

Checking the draft and starting the review

The draft review opens. In the draft stage, the author can check the contents of the review files to ensure they are correct and put in any notes for reviewers as comments. During the draft phase, no notification email is sent out to reviewers. Once the author is finished with the draft phase, he clicks Start Review.

The review will now be started and notification email will go out to all participants. Crucible will now send out an email notification to all the participants. This lets them know that the review is under way and prompts them to take action, providing a URL for direct access to the review. (You can also subscribe to an RSS feed.)

Next steps

You can now begin Performing the review.
If you have a moderator controlling your review process, you can move onto Starting a review.