Upsource 3.0 Help

Commenting without creating a review

Whenever you spot some minor issue in your teammate's code, want to post a reminder note, or start an informal discussion - you can leave comments without creating a review.

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

There are three types of comments:

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

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

Posted specific comment

To post a revision comment:

  • Type your message in the text field at the bottom and click Add Comment:
    General comment

To post a code selection comment:

  1. Open the file and go 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:
    Add specific comment

To post a line comment:

  1. In the revision home view expand the file and select the line you want to comment on by clicking the edit icon to the left:
    Add line comment
  2. Enter your message in the text box and click Add comment:
    Add line comment

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

Last modified: 14 September 2016