The change detail page shows what changed between two versions of a document, with two view modes and several pieces of metadata. This article walks through what each part means.
The header
The top of the page shows:
- Vendor and document. Which vendor, which document type.
- Detected at. When the change was first observed.
- Severity. Major, moderate, or minor — colour-coded.
- Review status. Unreviewed, reviewed, or marked-unreviewed.
- Review controls. Mark reviewed, unmark, override severity.
The summary panel
Below the header is a one-paragraph AI summary describing what changed. The summary is generated by Anthropic's Claude using the same diff the classifier sees, with a deterministic prompt — same input, same output.
For minor and moderate changes, a "Why [severity]" italic caption appears beneath the summary, briefly stating the reason the classifier chose that severity. This helps explain calls that look surprising at first glance.
Reading view (default)
The reading view shows the new version of the document with changes highlighted inline:
- Green strikethrough on removed text.
- Yellow background on added text.
This view is closest to how you'd read the document if you opened it on the vendor's site. It's best for understanding the meaning of the change in context.
Unified view
A toggle near the top switches to a unified diff view, similar to what you'd see in a code review:
-lines in red — removed.+lines in green — added.- Context lines in grey — unchanged surrounding text.
Unified view is best for spotting structural changes, scanning quickly, or copying specific lines for documentation.
Word-level highlighting
Within a changed block, individual changed words are highlighted at a finer grain than the line-level highlighting. This helps when a long paragraph changed only a single phrase — you can see the actual change without re-reading the whole paragraph.
The "Open original" button
Each version has an "Open original" link that opens the URL the version was fetched from, in a new tab. The link is the URL you tracked, not the redirect destination — useful for verifying the canonical URL is still serving the document.
Reviewing
Three review states:
- Unreviewed. The default for a newly-detected change. Counts toward the "unreviewed" badge in the sidebar.
- Reviewed. You've looked at the change and accepted/acknowledged it. Recorded in the audit trail with reviewer and timestamp.
- Marked unreviewed. You previously marked it reviewed but want to revisit. Treated like unreviewed for badges and exports.
Marking reviewed is a one-click action. The audit trail captures who and when.
Overriding severity
If you disagree with the classifier, you can change the severity. Both the original classification and your override are preserved in the audit trail.
The change feed and digest reflect the override; subsequent changes on the same document are classified independently (no learning from your overrides — the classifier is deterministic, not adaptive).
Looking at history
The "All versions" link on each document shows every version detected, with the diff between each pair. Useful when you want to trace a change back to its first appearance, or compare versions that aren't adjacent.