Review
Leave comments on the text, suggest changes that others accept or reject, and talk in the project chat. Everything here reaches everyone working on the project as it happens.
The Review panel
Click the speech-bubble icon (Comments and suggestions) in the project toolbar to open the Review panel. A badge on the icon counts the open comments and suggestions in the file you have open. The panel lists those for the current file, and says how many open comments are in other files.
Comments
Add a comment
- Select the text you want to comment on.
- In the Review panel, click Comment on the selection.
- Write the comment and click Comment, or press
Ctrl + Enter.
The comment is anchored to the text you selected. It stays attached to that text as people edit around it, and the text is highlighted in the editor. Click a highlight to open its comment in the panel. Click a comment in the panel to select its text in the editor.
Reply, resolve, and delete
- Reply: type in the reply box under a comment and click Reply, or press
Ctrl + Enter. - Resolve: click Resolve when the comment has been dealt with. Resolved comments move under Resolved at the bottom of the panel, where Reopen brings one back. Replying to a resolved comment also reopens it.
- Edit appears under each of your own messages, and Delete under each of your own replies.
- Delete at the bottom of a comment removes the whole comment and its replies.
Who can do what
- Add comments and reply: everyone the project is shared with, including people who can only view it.
- Resolve or reopen: people who can edit, and whoever started the comment.
- Delete a whole comment: the project owner, and whoever started the comment.
- Edit or delete a message: whoever wrote it.
Suggest changes
A suggestion is TeXeR's track changes: a change to the text that stays marked until someone accepts or rejects it.
Make a suggestion
Select the text you would change. Two buttons appear beside the selection: Comment and Suggest. Click Suggest, rewrite the passage in the card that opens, and click Suggest again (or press Ctrl + Enter). Only the part you changed is marked, so a changed word reads as that word and not as the whole passage.
Suggesting needs edit access. People who can only view a project can comment but not suggest. It also needs the live connection to the file; without it only Comment is offered.
How suggestions look
Text you insert stays in the file, underlined and shaded in a colour picked for its author. Text you delete stays visible where it was, in red and struck through.
The file always reads as if every suggestion had been accepted. Compiles and word counts include the inserted text and leave out the deleted text.
Accept or reject
The Suggestions section of the Review panel lists each suggestion with its author, whether text was added or deleted, and when. Click one to jump to it in the editor.
- Click the tick (Accept) to keep a change. The text stays as it is and the mark goes.
- Click the cross (Reject) to undo a change. A rejected insertion is removed; a rejected deletion puts the text back.
- Accept all and Reject all settle every suggestion in the file at once.
Accepting and rejecting need edit access.
Undo
Ctrl + Z takes back a suggested edit together with its suggestion. Accepting and rejecting are edits too, so Ctrl + Z right after one reverses it. Undo only takes back your own changes, never a collaborator's.
Project chat
Click the chat icon (Project chat) in the project toolbar. A dot on the icon means new messages arrived while the chat was closed.
Messages reach everyone the project is shared with, including people who can only view it, and stay with the project. Press Enter to send and Shift + Enter for a new line. A message can be up to 2,000 characters. Click Earlier messages at the top to load older ones.
Related
- Collaboration: invite people and choose their roles.
- Visual mode: comments and suggestions work there too.