[Crucible Knowledge Base]
This page explains 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:
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.
Before a review can be issued to reviewers, you must decide who can review it. When adding reviewers, you can add registered users immediately. The usernames will auto-complete, showing partial matches before you finish typing. You can quickly select one of the matches shown with the keyboard arrow keys, pressing Enter or Tab to add them to the review.
In addition, you can easily invite external users who do not yet have accounts in Crucible to take part by typing their email address into the Reviewers field.
Select users by typing names into the text field under Reviewers. Crucible will show a list of matches. Press Enter to select one after each entry.
Clicking Done will save the review as a draft for later issue.
You can also decide to allow any registered user to add themselves as a reviewer in the review. To enable this option, select Allow anyone to join.
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.
You can invite users who don't have a Crucible account to join a review.
There are two prerequisites:
To invite an external user to a review:
You can enter multiple addresses separated by commas, allowing you to paste in a list of email addresses from your favourite email application.
When finished, the author clicks Save. The review will now be created in a draft form.
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.
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.)
Screenshot: A newly created Crucible review