Crucible 2.3 : Selecting the Files for the Review
This page last changed on Jan 26, 2010 by edawson.
This page explains how to select files that will be included in a Crucible review. The Manage Files dialog allows you to select and modify which files make up the review. In the Manage Files dialog, the author selects the source files they want to include in the review, by clicking the checkboxes next to the desired files. Once finished, the author clicks 'Done'. On this page:
Overview of the Manage Files DialogThe 'Manage Files' dialog is first displayed when you are creating a review. Once a review has started, (as the creator or moderator) you can reopen the dialog by clicking the Manage Files button on the Review toolbar. The left navigation bar allows you to select and locate different files for the review including files from repositories, patch files and uploaded files. The screenshot below shows the view shown when checking the list of currently selected files; the 'Review Content' view. Screenshot: The Review Content View Under the Manage Files Dialog See the table below for detailed instructions on the various links on the left navigation bar of the Manage Files dialog. Left Navigation Bar Links In The Manage Files Dialog
Screenshot: Red Dot and Comment Counter in the Manage Files Dialog Selecting Changesets for ReviewTo add changesets to a review, open the 'Changesets' view by clicking the "Changesets" option on the left navigation bar in the Manage Files dialog. The Changesets view opens. Screenshot: The Changesets View in the Manage Files Dialog By default, Crucible presents a list of the author's changesets in reverse chronological order. You can see other changesets by changing the options at the top of the screen. Click the checkbox next to a changeset ID to add the entire changeset, or the checkboxes next to file names to add or remove individual files. Clicking the checkbox of a parent item will select or de-select all of its children. Click 'Remove all revisions from review' to remove all. Options for Adding Changesets
Understanding the Icons Shown with ChangesetsTo help decide what files are to be placed under review, you can click the icons next to the files to gain further information about them before they go out for review:
After you have chosen the files, click the 'Review Content' option on the left navigation bar to view the files that are included in the review. Selecting Files for ReviewTo add files to a review, click the 'Files' option on the left navigation bar of the Manage Files dialog. The Files view opens. To find a file, browse the folders by clicking the relevant folder. The folders by default are sorted by path name but can sorted by last-commit or first-commit. To choose a file for reviewing, click the checkbox to the left of the filename and if required the revision number. To select a particular revision of a file, open the revision number list and select the option "Load Full History...". This will refresh the available options in the list. Caveats:
After you have chosen the files, click the 'Review Content' view to see the files that are included in the review. Screenshot: Files View in the Manage Files Dialog Searching in the Manage Files View
Screenshot: The Search View in the Manage Files Dialog If you are not certain about which changesets/revisions/files to include in a review, use the Search view to find them. Adjust the search filters to find the files you need. If the simple filters are not enough, read about EyeQL queries in the FishEye documentation. After you have chosen the files, click the 'Review Content' view to see the files that are included in the review. Read the FishEye documentation for more information about the searching your repository. Viewing the Content Selected for ReviewTo look at the list of content selected for the review, click the 'Review Content' option on the left navigation bar. The Review Content view opens. In this view, you can look over the list of items selected for review. For each item, you can click its name to see which revisions are included in the review. In that view, you can also remove individual files or content items completely (by clicking the small red 'X' icons over each item), as well as adding or removing individual revisions. Screenshot: The Review Content View in the Manage Files Dialog Using the Suggestions Feature When Adding Files to a ReviewCrucible can make intelligent suggestions when you are creating a review. Once you have selected some files, click 'Suggestions' in the left navigation bar to let Crucible analyse your selection and make some recommendations to you. The Suggestions feature logic is based around the following:
Screenshot: The Suggestions View in the Manage Files Dialog Adding Patch Files to a ReviewFor a full explanation of the 'Patch View' functions, read about creating a patch review. Uploading Files to a ReviewYou can upload additional files to be used in the review, including binary files, images or code files that are not stored in a version control repository. The 'Upload' view contains various controls to help you do this. These are listed in the table below.
When you've made your selection, simply click the 'Upload' button. Once complete, a list of uploaded files is displayed at the bottom of the screen. Screenshot: Upload View in the Manage Files Dialog Choosing the Form of the ReviewWhen adding files to a review, you can set the form of review taking place. Several options are listed along the top of the 'Manage Files' dialog, in the Add to Review as: drop-down menu: Screenshot: File Addition Options in the Manage Files Dialog
![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() |
![]() |
Document generated by Confluence on Jul 29, 2010 20:00 |