Upsource 2020.1 Help

Discussion comments

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 or a group, just type @ in the text field followed by the person or group name (you can choose it from the pop-up list). Addressed (mentioned) users - either individually or as a group - are notified in their emails and assigned as watchers (if the discussion is part of a review).

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 Start new discussion:

    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:

    CR_addLineComment.png

  3. Enter your message in the text box and click Add comment:

    CR_lineComment2.png

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:
comment_tools.png
  • comment_timestamp_icon.png Click the timestamp to open the Discussions page where you can view, filter and search all discussions in the project.

  • comment_edit_icon.png Click to edit you comment.

  • comment_link_icon.png Click to follow a permanent link to the discussion.

  • comment_sync_icon.png Indicates that the comment is synced with GitHub (in GitHub projects).

  • comment_reactions_icon.png Click to choose and add a reaction to the comment.

  • comment_resolve_icon.png Click to mark the discussion as Resolved when a discussion thread comes to a logical end.

  • comment_reply_icon.png Click to reply to the comment.

  • comment_labels_icon.png Click to add a label to the discussion. See Discussion Labels for details.

You can also:

  • Use Markdown.

  • Attach an image or any file to your comment — just drag-n-drop or copy-and-paste it into the text field. Attached images will be displayed right in the comment.

  • Create a task list that will render with clickable checkboxes in your comment.

Last modified: 02 April 2021