Skip to content

Show what /graph actually produces - #38

Merged
barkz merged 1 commit into
mainfrom
docs/graph-screenshot
Sep 12, 2026
Merged

barkz merged 1 commit into
mainfrom
docs/graph-screenshot

Conversation

@barkz

@barkz barkz commented Sep 12, 2026

Copy link
Copy Markdown
Owner

Both /graph documents described the HTML view in prose and left the reader to imagine it.

assets/graph_example.png is a real run — /graph "access review" --html access.html against the mock corpus — with the hub document selected, so the screenshot carries the part that matters: neighbours stay lit while everything else dims, and the panel lists all nine of that document's edges, each with the words that earned it and the score they carry.

Added to:

  • docs/GRAPH.md — under The HTML view, with a caption naming the command that produced it
  • docs/COMMANDS.md — in the /graph entry, under Output

The terminal half goes in as text rather than a second image: a code block is copyable, searchable and readable by a screen reader, which a picture of a terminal is not.

On how it was captured: the screenshot triggers the same code path a click runs, once the layout has settled. Nothing about the rendering is staged — it's the file --html wrote, opened at 1480px.

Tests

1,148 → 1,151. A docs image is an asset like any other and can go missing, so the suite now checks it exists, really is a PNG (magic bytes), is referenced from both documents by a path that resolves relative to each document, and carries alt text longer than a placeholder.

🤖 Generated with Claude Code

Both /graph documents described the HTML view in prose and left the
reader to imagine it. assets/graph_example.png is a real run —
/graph "access review" --html against the mock corpus — with the hub
document selected, so the screenshot carries the part that matters:
neighbours stay lit while the rest dims, and the panel lists all nine
of that document's edges, each with the words that earned it and the
score they carry.

The terminal half goes into the COMMANDS.md entry as text rather than
a second image: it is copyable, searchable and readable by a screen
reader, which a picture of a terminal is not.

The capture triggers the same code path a click runs, once the layout
has settled — nothing about the rendering is staged.

Tests: 1,148 -> 1,151. The image is an asset like any other and can go
missing, so the suite checks it exists, really is a PNG, is referenced
from both documents by a path that resolves from each one, and carries
alt text.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@barkz
barkz merged commit ff5be15 into main Sep 12, 2026
7 checks passed
@barkz
barkz deleted the docs/graph-screenshot branch September 12, 2026 18:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant