Upsource Web 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.

Note: If the revision you’re commenting is covered by a review, you may choose to include your comments into that review.