Documentation for Crucible 2.10.x. Documentation for other versions is available too.

Comments can be added at the level of a review, revision, or line. You can also reply to a comment.

On this page:

Locating existing comments

The number beside a filename, in the left-hand panel of a review, indicates the number of comments on that file.

(The number of unread comments, if any, is shown in brackets.)


Screenshot: Comments

Adding comments

There are various types of comments that you can add in Crucible:

To comment on... 
The whole reviewClick General Comments (in the left-hand panel), then Add a general comment (in the 'General Comments' section).
A source file under reviewClick on the file in the left-hand panel, then click Add a file comment at the top of the file.
Lines of code

Click on a line of code in the displayed source file of a review.

  • You can click and drag to select multiple lines, and click individual lines to select or deselect them. The comment will appear in the source at the last line selected. 
  • Hover over the comment to see the lines to which the comment applies.
  • To select text on the page without adding a comment, hold down the Alt key while dragging the cursor.
A revision or changeset

See Changeset discussions.

To reply to a comment, click Reply at the bottom of the comment.

(warning) Only people with the 'Comment' permission can add comments.

(info) Read about flagging defects too. 

Screenshot: Adding a Comment

Draft comments

You can save your comment as a draft and then edit it later. When you complete the review, you will be prompted to post, discard or edit any remaining draft comments.

Screenshot: Draft comments

3 Comments

  1. Anonymous

    Feb 06, 2013

    What is the quickest way to navigate through JUST the unread comments?  We have some reviews that have been open for a while where new comments are being added over time. I want to navigate directly the unread comments without having to review those comments I have already reviewed.

    1. Anonymous

      Feb 06, 2013

      I just found my answer. The left and right bracket shortcut keys will navigate between unread comments.

  2. Anonymous

    Mar 05, 2013

    A Crucible Code Review Comments issue:  When a reviewer completed a review, if the author replies with some comments over the reviewer’s comments, the reviewer does not get a notification about the author’s comments unless the reviewer re-open the completed review.  The reviewer is simply not aware of the author has some comments over the previous comment.

    How to solve this issue?

 

 

 Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.