Upsource 2017.2 Help

Discussion comments

On this page:

You can post comments, addressing them to other participants, and reply to the comments left by others.

A discussion can consist of one or more comments (replies).

To address your comment to a specific person, just type @ in the text field followed by his/her username (you can choose it from the pop-up list).

There are three types of comments:

  • Review comment is not tied up to any particular file or part of code — its subject matter may be anything within the scope of the review.
  • Code selection comment is intended to pinpoint a particular code fragment in one of the files being reviewed.
  • Line comment is associated with a specific line of code.

Comments that are relevant to you also appear in the news feed.

Posting comments

To post a review comment

  1. On the Review page, select Review summary (it's the default view).
  2. Enter your message in the text box and click Add comment:
    CR_comment.png

To post a line comment

  1. On the Review page, select the desired file to display the inline diff:
    CR_click_file_for_diff.png
  2. Select the line you want to comment on by clicking the edit icon to the left:
    Add line comment
  3. Enter your message in the text box and click Add comment:
    Add line comment

To post a code selection comment:

  1. On the Review page, select the desired file and go to Side-by-side diff or View file.
  2. Select the lines you want to discuss and choose Comment on selection from the pop-up menu.
  3. Type in your message and click Add Comment
    CR_commentMenu.png

Posted code selection comments and line comments are embedded in code and highlighted with yellow.

CR_inlineComment.png

When a discussion thread comes to a logical end, either you or the reviewer can mark it as resolved.

Discussion options

Place your cursor over the comment to make the options visible:
/help/img/upsource/2017.2/comment_tools.png
  • /help/img/upsource/2017.2/comment_timestamp_icon.png Click the timestamp to open the Discussions page where you can view, filter and search all discussions in the project.

  • /help/img/upsource/2017.2/comment_edit_icon.png Click to edit you comment.

  • /help/img/upsource/2017.2/comment_link_icon.png Click to follow a permanent link to the discussion.

  • /help/img/upsource/2017.2/comment_sync_icon.png Indicates that the comment is synced with GitHub (in GitHub projects).

  • /help/img/upsource/2017.2/comment_reactions_icon.png Click to choose and add a reaction to the comment.

  • /help/img/upsource/2017.2/comment_resolve_icon.png Click to mark the discussion as Resolved when a discussion thread comes to a logical end.

  • /help/img/upsource/2017.2/comment_reply_icon.png Click to reply to the comment.

  • /help/img/upsource/2017.2/comment_labels_icon.png Clck to add a label to the discussion. See Discussion Labels for details.

Last modified: 26 October 2017

See Also