Working with a finding
Open a highlight, read what the card is claiming, and tell the app when a finding does not apply to your case.
A row in the panel tells you there is a problem. The card behind it tells you what the problem actually is, and gives you enough to decide whether you agree.
Opening a card
Click a finding row in the panel, or click the highlighted words in the draft. Either one opens the same card.
Where it opens depends on whether the check could find those exact words in your text. When it could, the card appears glued just under the marked line, with the words staying washed while it is open. When it could not, the card opens beside its panel row instead. A problem card does not repeat the quoted words; a Worth keeping card does, because there the quoted line is the finding.
Clicking anywhere inside a highlighted passage opens that finding, because the card follows the text cursor. Moving the cursor in and out of a mark with the arrow keys opens and closes cards too.
What the card tells you
A problem card has three parts, and they do different jobs:
- Reason — what your words observably do, and why that costs you the reply. If this is wrong, the rest of the card is wrong.
- Revision requirements — the boxed list, and the only instruction on the card. Each line is a condition a fix has to satisfy, and there is always at least one.
- This changes if — a faint closing line naming when the finding stops holding. Present only when the check had one to state.
A card opened while the check is still streaming carries no labelled sections at all, because they are written when the run settles. Wait for it to finish and the card fills in.
A result stored before the current shape opens in its own older layout, with labels this page does not use. Nothing is invented to fill what was never recorded.
A Worth keeping row opens a card of its own. Its header reads Keep where a problem shows a severity, and its box is Preserve or Keep this in a rewrite — what to hold on to if you rewrite around it.
There is no Apply, Accept or Insert button anywhere on a card. Revision requirements are conditions you satisfy yourself, in your own words; unpitch never edits your draft for you.
A Simulation finding is thinner still. It always shows Reason, and adds a boxed Reader thought when the finding names one of the reader's thoughts, plus the quoted words when the draft is not already marking them. A finding about the message as a whole has neither, so its card is the reason alone. None of them carries revision requirements, because a reader reacts and does not advise.
Closing a card
Press the ✕ (its accessible name is Dismiss), press Escape, click anywhere else, or start typing in the draft. Typing is the intended way to close a card and keep working, so you cannot leave one open over the line you are rewriting.
Closing a card is not a judgement on the finding. It only puts the card away.
Telling the app a finding is wrong
At the bottom of a problem card is a quiet dotted-underline control, Not a problem. Press it when the finding does not hold for your case — often the situation This changes if just described.
What changes when you press it:
- The card reads Undo, with You marked this not a problem beside it.
- The panel row's title is struck through and muted, and its severity badge fades.
- The row sinks to the bottom of its own step group, but keeps its place in the list and still opens its card.
- Its highlight stops being painted in the draft.
What does not change is every count on the panel. The finding is set aside, not deleted, so the headline, the counts line and the section totals stay exactly as they were. If you expected it to disappear, it worked and it looks like it did not.
Press Undo on the same card to take the judgement back.
A judgement belongs to one run and to one person. Re-running the check produces a new run, so findings you set aside come back unmarked even when the same issue is raised again. And what you set aside is yours: it does not change what a colleague opening the same run sees.
A few places offer no such control. Worth keeping rows and Simulation findings cannot be marked, and neither can a card that shows one unlabelled paragraph and nothing else. Older stored cards that still carry labelled sections can. The control also stays away while a check is still streaming its findings in.
If the press cannot be recorded, the row snaps back to how it was and a toast reads Could not save that. Please try again.
There is no opposite control. Nothing on the card says you agree with a finding, because agreeing with it means changing the draft.