Comments and suggested changes
Discuss a passage with comments
Section titled “Discuss a passage with comments”On desktop:
- Select the passage in the source editor.
- Click Enter comment… beside the selection and type your comment.
- Click Post to save it.
You can also use the Comments panel: select a passage, enter your message in Comment on the selected text…, then click Comment. On mobile, use this panel in the sidebar drawer; the floating selection composer is desktop-only.
Comments are attached to source positions, not inserted as Typst source text. They do not become part of the normal compiled document. In live collaboration, anchors follow the text as collaborators edit it.
Read, reply, and resolve
Section titled “Read, reply, and resolve”Click a highlighted passage or its comment marker in the gutter. On desktop, this opens the thread beside the passage. On mobile, it opens the Comments drawer. The panel’s List all comments control is useful for reading all threads together.
These screenshots use demonstration names and a sample document.
- Reply: type in the thread’s reply field and press Enter or use Send reply. In the panel, click Reply to open the field.
- Resolve: mark the discussion as handled. Use Reopen if it needs more work.
- Delete thread: use the trash button and confirm to remove the thread and its replies. Deleting an individual reply uses its own trash button.
Author names and timestamps identify the messages in the thread. Viewers can read comments but cannot post, reply, resolve, or delete them. Escape or a click outside the desktop popover closes it; Escape inside the reply field clears that reply draft first.
Use comments for questions, explanations, and decisions. Mod+Shift+Down/Up moves between available comments from the editor.
For a paper, ask whether a method is reproducible. For meeting minutes, ask whether a decision reflects the agreement. For a revision sheet, anchor the question to an exercise or answer that needs clarification.
When comments refresh
Section titled “When comments refresh”When connected, the server notifies your open document about new comments, replies, edits, resolutions and deletions, so threads usually update promptly. Tylor also checks once a minute while the tab is visible in case a notification was missed. If notifications are unavailable, it checks every ten seconds instead.
Returning to the tab or coming back online refreshes the threads. Hidden tabs pause incoming comment-list refreshes until you return. Posting a comment or reply also refreshes your local thread list.
Offline comments are saved on your device and queued for sync. Pending local operations can delay incoming updates until they replay. A failed refresh keeps the last loaded threads visible. If posting reports an error, your text stays in the field so you can retry. Check saving and offline use before moving to another device.
Propose a change
Section titled “Propose a change”Turn on View → Suggest changes (track), then edit the source. Insertions are marked in green. Deleted text appears as a struck-through marker at its former position.
Open the Tracked-changes panel or an inline suggestion to review it:
- Accept keeps the proposed edit and removes its tracking record.
- Reject undoes the proposed edit, then removes its tracking record.
Understand the preview
Section titled “Understand the preview”AI edits also use the suggestion workflow when offered as tracked changes. Check the meaning, source syntax, and compiled result before accepting them.
Allow review operations to sync before changing devices. If you have pending offline comments or suggestions, preserve the browser’s data until the queue has reconciled.