# Review

> Review a LaTeX project together in TeXeR: comments on the text, suggested changes that others accept or reject, and a chat for everyone on the project.

From the TeXeR docs (Guides): https://texer.org/docs/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

1. Select the text you want to comment on.
2. In the Review panel, click **Comment on the selection**.
3. 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.

> **Tip: 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](https://texer.org/docs/collaboration): invite people and choose their roles.
- [Visual mode](https://texer.org/docs/visual-mode): comments and suggestions work there too.
