Comments and suggestions let you discuss and review a document without silently changing it. Both live in the comments panel.
Open the comments panel
Click the speech-bubble button in the toolbar above the right-hand panel.
A red badge counts unresolved items. The panel has three views, All, Comments and Tasks, and a Resolved switch that shows finished items too.
Add a comment
- Select the text you want to comment on.
- In the popup that appears, switch to comment mode (the speech-bubble-plus button), type your comment and press
Enter.
You can also select text, then write in the box at the bottom of the comments panel and click +.
The commented passage is highlighted in the editor. Each comment shows its author and date.
Reply, edit, resolve
On a comment card you can:
- Reply, to keep the discussion in one thread
- Edit, for your own comments
- Resolve, when the point is dealt with. Turn on Resolved and choose Reopen to bring one back
- Delete
Type @ in a comment to mention a collaborator. Pick the person from the list and they get a notification. Only people with access to the project can be mentioned, and a mention fires once, when the comment is created, not when you edit it.
Suggest mode
Suggest mode records your own edits as reviewable suggestions, like track changes.
-
Click the Suggest Mode button in the editor toolbar.
The Suggest Mode button. -
Edit as usual.
Your text goes into the document right away, and a card appears in the comments panel once you pause typing. Edits made in one burst are grouped into one card. Click the button again to go back to editing directly.
Reviewers are always in suggest mode. The button is locked on for them, because their role cannot edit directly.
Approve or reject a suggestion
Each suggestion card has Approve and Reject:
- Approve keeps the new text and closes the card.
- Reject reverses the edit and restores the original text.
Edits proposed by the AI assistant are reviewed the same way.
Tasks
The Tasks view lists markers found in your LaTeX source:
% TODO: ...comments and\todo{...}from the todonotes package% STOPSHIP: ...comments
A STOPSHIP marker blocks PDF download until you remove it. See Export.
The Comments and All views also list % name: note comments addressed to a person.