Creating a Review within Crucible

This page explains how to create a review from the Crucible interface.

On this page:

Create a new review

Within Crucible, create a review by opening the Tools menu at the top right of the Reviews screen, then clicking Create Review. You will be prompted to select the Project for the review (if you have multiple projects). Choose a project and click 'Create Review'.

Screenshot: The create review dialog

Choose where your review files will come from

The 'Add Content to Review' screen appears, where you will now be prompted to choose where your review files will come from. Choose one of the options by clicking. See Selecting the Files for the Review for details.

Screenshot: The content menu for Crucible reviews

Add content to the review

Once you select where your review files are coming from, you are prompted to select the files to be reviewed. Check the boxes next to any files you want to add.

Screenshot: Adding content to your review

Edit the review details

Once you have selected the files, click Done to go to the Edit Review Details screen, as shown below.

Screenshot: Editing review details


On the Edit Review Details screen, you can choose a title, reviewers, objectives, due date, linked reviews and issues. Once you're finished, click 'Done'.

Screenshot: Editing review details


The review will open in a preview form. Here, you can check all the details and click to edit any that aren't correct. Once you click Start Review, the review is live.

Adding an entire directory's contents to a Crucible review

To add an entire directory's contents to a Crucible review, you will need to search to find all the files. For example, using "select revisions from dir /some/dir where is head", or similar logic.

It is currently not possible in Crucible to add all the contents of a directory to a review with one click.