docs(website): screenshots for the seven pages the 0.66 audit flagged as image-less - #785
Merged
Conversation
…tool picker and Home Seven pages the 0.66 audit flagged as wanting an image and having none. Captured against a synthetic rig (fictional projects, /home/demo paths, stock branding) driven by a committed, re-runnable script rather than by hand, because the visual design overhaul in flight will make every one of these stale and the re-shoot has to be a re-run. Each shot is framed on its subject rather than the whole window: a 16x16 provenance badge inside an 1180px frame is unreadable in the docs column. Co-Authored-By: Claude <noreply@anthropic.com>
…enshots Re-shooting after the design overhaul has to be a re-run, not a human re-deriving a dozen navigation paths, so the script ships with the images. Sanitised for a public repo: no absolute paths into one machine's clone, no private dev domain, base URL and output dir from flags or env. Site-specific leak patterns move to $PADDOCK_LEAK_EXTRA — hard-coding a private domain in the detection regex would publish the string it guards, which an earlier draft did. The rig launcher is deliberately not committed; the README states the contract it has to satisfy instead. Co-Authored-By: Claude <noreply@anthropic.com>
Deploying paddock with
|
| Latest commit: |
ccad491
|
| Status: | ✅ Deploy successful! |
| Preview URL: | https://8a26ca74.paddock-7u2.pages.dev |
| Branch Preview URL: | https://docs-screenshots-0-66.paddock-7u2.pages.dev |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The v0.66 docs audit flagged seven pages that lean on describing a UI they never
show — the whole
guides/tree carried zero images, andgetting-started.md,the highest-traffic page, had none either. This adds one image to each, plus the
script that made them.
Follows #776, #777, #778, #779.
What is shown
using/working-in-chats.mdusing/working-in-chats.mdusing/working-in-chats.mdusing/creating-and-organizing-projects.mdusing/sending-files-and-images.mdguides/agent-capabilities.mdgetting-started.mdnpx @edspencer/paddock --hereEvery image has real alt text describing what is in the frame.
Where they came from
A synthetic instance — fictional projects, fictional chat titles,
/home/<demo>paths, stock branding. No copy of anyone's real data was involved, so there is
nothing to scrub. Each frame was scanned at the DOM level before it was written
and then looked at.
The attachments shot needed state that did not exist: an attachment lives in the
attachment store, not in the transcript JSONL, so
stage-attachments.mjsdrivesthe two real steps a browser takes (multipart upload, then
chat:sendcarryingthe returned ids) rather than hand-writing a
.jsonland risking a shape the UIonly renders by accident.
Why the tooling is in the PR
A visual-design overhaul is in flight (#763–#767, #780–#783), so every one of
these will go stale at once. That is accepted deliberately: the prose is worth
illustrating now, and re-shooting is
node capture.mjsrather than a personre-deriving a dozen navigation paths. The script is sanitised for a public repo —
no absolute paths into one machine's clone, no private dev domain, base URL and
output from flags or env, and site-specific leak patterns in
$PADDOCK_LEAK_EXTRA. Hard-coding a private domain in the detection regexwould publish the string it guards; an earlier draft did exactly that.
Two framing bugs were fixed while re-shooting, both recorded in the script's
comments: an unframed element shot of a scrollable list is ~40% empty because a
list is as tall as its viewport rather than its content, and two unframed shots
of the same URL at the same viewport land as byte-identical files — which is
how one earlier capture appeared to be two.
Verification
npm run buildinwebsite/— clean, 51 pages, all seven images processedinto
dist/_astro/*.webpcaddyfilehighlight warnings in the build log predate this branch (2 on thev0.66.2 tag, 2 on
main)Docs-only: no changeset, no version bump.
🤖 Generated with Claude Code