This page last changed on Jun 29, 2009 by rosie@atlassian.com.

This page contains instructions on using the 'Favourites' feature in Crucible to select, view and manage items of interest.

On this page:

Favourites Overview

Crucible allows you to tag certain items as your favourites. You can select code reviews, changesets, files, people and repositories to be added to your favourites. Once your favourites list is created, you can view it or see a stream of all activity relating to your favourite items. We suggest you select items that you are currently working on as favourites, to create a more relevant personalised view.

Adding Items to Your Favourites

To add an item to your favourites, follow one of the steps below.

Adding a Review to Your Favourites

To add a review to your favourites, hold the mouse cursor over the review name when it appears in a menu screen. The Review Hover menu appears. At the top right of the Review Hover menu, click the small grey cog icon that indicates the 'Tools' menu. The Tools menu opens. In the Tools menu, click 'Add Star'. This will add it to your favourites.

Screenshot: Adding a Review To Your Favourites

Adding a Review Comment Thread to Your Favourites

To add a review comment thread to your favourites, click the link 'Add Star' next to the grey star icon at the bottom of the first comment of the thread. From then on, new comments will be shown in your favourites activity stream.

Screenshot: Adding a Review Comment Thread to Your Favourites

Adding a Project to Your Favourites

To add a project to your favourites, click the 'Projects' tab. The Projects view appears. Here, simply click the grey star icon that appears next to the desired project name. The star icon will turn yellow, showing that it is selected as a favourite.

Screenshot: Adding a Project to your Favourites

Adding a Person to Your Favourites

To add a person to your favourites, simply hold the mouse cursor over their username wherever it appears. The User Hover menu will appear. In the User Hover menu, click 'Follow'. This will add the person to your favourites.

Screenshot: Adding a Person to Your Favourites

Adding a Changeset to Your Favourites

To add a changeset to your favourites, firstly open the changeset desired from the 'Source' tab. Once the changeset is open in Crucible, simply click the grey star icon that appears next to its name. The name appears in the breadcrumb links at the top of the screen.

Screenshot: Adding a Changeset to Your Favourites

Adding a File or Folder to Your Favourites

To add a file to your favourites, firstly open the file or folder desired, from the 'Source' tab. Once the file or folder is open in Crucible, simply click the grey star icon that appears next to its name. The name appears in the breadcrumb links at the top of the screen.

Screenshot: Adding a File or Folder to Your Favourites

Adding a Repository to Your Favourites

Adding a repository to your favourites (requires FishEye), click the 'Source' tab. The the 'Source' view appears. Here, simply click the grey star icon that appears next to the name of the desired repository. The star icon will turn yellow, showing that it is selected.

Screenshot: Adding a Repository to Your Favourites

Viewing Your Favourite Items

To view your favourite items, click 'Dashboard' tab at the top left of the page and then the 'Favourites' second level tab, beneath that.

Screenshot: Viewing Your Favourites

Renaming an Item In Your Favourites

To rename an item in your favourites, open the Favourites drop-down menu (the gold star icon located at the top centre of the Crucible screen, next to your user menu). Select the option called 'Manage favourites'. The Dashboard favourites page opens, showing all of your favourites in the system. To rename any item (changing its favourite display name only — not the name of item itself), simply click the yellow star to the left of its name. A small pop-up menu will appear, the 'Update Favourites' menu. Type the desired name into the 'Name' field and click the 'Save label' button. The label will be updated for the favourites view.

Screenshot: Renaming an Item in Your Favourites

Removing an Item From Your Favourites

To remove an item from your favourites, open the Favourites drop-down menu (the gold star icon located at the top centre of the Crucible screen, next to your user menu). Select the option called 'Manage favourites'. The Dashboard favourites page opens, showing all of your favourites in the system. To remove any item, simply click the yellow star to the left of its name. A small pop-up menu will appear, the 'Update Favourites' menu. Click the 'Remove' button. The star will turn grey, showing that it has been removed from your favourites.

Screenshot: Removing an Item From Your Favourites


Document generated by Confluence on Feb 23, 2010 02:04