This documentation relates to Crucible 2.7.x

If you are using an earlier version, please view the previous versions of the Crucible documentation and select the relevant version.
Skip to end of metadata
Comment: Corrected links that should have been relative instead of absolute.
Go to start of metadata

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.

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

5 Comments

Hide/Show Comments

  1. Aug 20, 2010

    Joe Fischer

    When creating a review, after selecting files and clicking done, the documentation says that I will go to the Edit review details screen.  I get the preview form instead.

  2. Apr 13, 2011

    Anonymous

    Can the author of a review be the reviewer?  If I find a commit or changeset on which I want to provide feedback, I would like to create a review, add the comments (review), and complete (sending it to the code author).  The way I see it, I cannot be both review author and reviewer.  Is this true?  Must the code committer create the review, so that I (the reviewer) may review it?

  3. Apr 28, 2011

    Bartosz Staniszewski

    I have similar question to previous one:

    is it possible to configure Cruicible in a way that creator is not assigned as author during review creation?

    My problem is similar - i want to start review of code coming from other developers.

    1. May 09, 2011

      Bartosz Staniszewski

      I found solution ;-)

      During creation or edit of review it is possible to change author. This option is hard to recognise, but if you would like to change author, just point mouse cursor on current author name, then you will see combo with all users.

      This allows to realize scenario where creator ia not an author of the code, e.g. i found dangerous piece of code and i create review. Then i change author in review to real one. Next i can even assign me as a reviewer!

      The only problem is that this is not properly described in Crucible documentation and it is not easy to find that in details screen, author is changeable.

  4. Nov 30, 2011

    Adam Koch

    Within Crucible, create a review by opening the Tools menu at the top right of the Reviews screen, then clicking Create Review

    This is incorrect in my version (2.7.5) of Crucible.