Skip to content

docs(readme): tighten the layouts captions and intro - #17

Merged
Shironex merged 2 commits into
mainfrom
docs/readme-copy
Sep 27, 2026
Merged

Shironex merged 2 commits into
mainfrom
docs/readme-copy

Conversation

@Shironex

Copy link
Copy Markdown
Contributor

Small copy fixes to the README after #16.

  • Captions: the layouts table's first caption explained Nightjar again ("Hero layout spotlight, for Nightjar (the gallery fixture app)"), which the banner caption and the intro already do, so the four captions read unevenly. site/gallery/readme.config.mjs drops its caption fields, the shot titles serve as captions (Hero: spotlight, Hero: row, Hero: mosaic, Frame: browser), and the README carries the table showcase readme printed. The site test that keeps the README table verbatim failed before the README update and passes after it.
  • Intro: "A few of them below, for Nightjar, ..." was a fragment; it now reads "Below are four of them, rendered for Nightjar, a made-up app the gallery captures (not the kit's own UI). showcase readme printed the table itself."
  • Quick start: npx showcase readme # print the README table now says # print the README snippet (--layout for the others).

bun run docs:gallery regenerated only site/gallery/readme/kit-readme.html: every image is byte for byte the same (budget 1791.0 KB of 4096). bun run --cwd site test (174 pass) and bun run docs:build pass.

The images that showed as broken right after #16 merged were the Pages deploy still running; they load now.

…tles

The README's layouts table explained Nightjar again in its first caption, which the intro and the banner caption already do. The shots' titles (Hero: spotlight, Frame: browser, ...) now serve as the captions, and the README carries the regenerated table.
…ment

The layouts intro opened with a sentence fragment, and the quick start still said showcase readme prints a table, though it has five layouts since 0.3.0.
@Shironex Shironex added documentation Improvements or additions to documentation area: readme showcase readme: the README image table (src/readme.ts) labels Sep 27, 2026
@Shironex
Shironex merged commit d5d57dc into main Sep 27, 2026
10 of 11 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area: readme showcase readme: the README image table (src/readme.ts) documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant