06Documentation
Changes
How to read the colours in the text, what the cards beside the page do, and how to accept or discard a change.
Three colours
Everything in which the draft differs from the last accepted version shows in the document:
- Green — text that was added.
- Amber line — text that was reworded. The old word in it is struck through in red, the new one is green.
- Red and struck through — text somebody removed.
The card of a change
Every change has a card beside the page. It shows what changed and offers:
| In the app | What it means |
|---|---|
| ✓ Accept change | The change is done and stays in the draft as it is. |
| ✗ Discard change | The text goes back to what it was before this change. |
| Ask the author (the bubble with a plus) | You write a note on the change. The person who made it answers. |
| Two stacked rectangles | Shows the previous and the new wording one above the other, each in one piece. Useful when a whole paragraph was rewritten. |
A change made by the agent also carries its Why (AI) note on the card — the reason it made the change.
Going through the changes
Above the cards is a counter — 4 changes, say — with arrows up and down that jump to the previous and the next change. Accept · next change accepts the change you are on and moves you to the next; a long document is done with one button.
The narrow strip at the far right is a miniature of the whole document. The coloured lines in it show where the changes are; click a place to jump there.
All at once
The three dots ⋮ beside the counter (All changes in this file) offer Accept all and Discard all — for the whole document.
Turning the marking on and off
The Markup button in the bar — with its counts, “Markup: 4 · Notes 2”, say — hides the colours and the cards or shows them again. The changes do not go away; you just stop looking at them for a while.
Accepted is not published
✓ only says “this is done”. An accepted change moves from the Live stack to the Accepted stack — and is still only in your draft. It reaches the approved version, the one everybody reads, when it is published. That is the chapter Approving and publishing.