Reviewing Text Files¶
Much like diffs, text files can be reviewed. This is useful for reviewing out-of-band files such as documentation or notes, and can also be used to review full source files (as opposed to changes to source files).
To begin reviewing a text file, just click the thumbnail for the file attachment on the review request page.
Reading Existing Comments¶
Any existing comments will show up as blue clickable comment flags along the left-hand side of the text file. Each comment flag corresponds to a line containing a comment.
If you move the mouse cursor over the comment flag, a tooltip will appear showing a summary of the comments made.
If you click on the comment flag or line number, the comment dialog will appear, along with a blue side panel on the left showing those existing comments. You can still write new comments in the green area of the comment box.
It’s important to note that this is not the place to reply to those comments. When you add a comment from the diff viewer, it’s creating a new top-level review (akin to a new thread). If you want to reply to existing comments, you can do so from the Reviews page. The Reply link here is a shortcut to jump directly to the relevant comment on the Reviews page.
The view here is meant to be used only as a reference to see if other people have already said what you plan to say.
Viewing Other Text Revisions¶
New in version 2.5.