Skip to content

Add draft post: I made my book accessible by writing it like software - #1950

Open
benbalter wants to merge 8 commits into
mainfrom
post/accessible-by-default
Open

Add draft post: I made my book accessible by writing it like software#1950
benbalter wants to merge 8 commits into
mainfrom
post/accessible-by-default

Conversation

@benbalter

@benbalter benbalter commented Aug 4, 2026

Copy link
Copy Markdown
Owner

Update (2026-08-17) — now that the flagship went live at /2026/08/17/ (not the /2026/08/03/ this draft assumed) and got a full human rewrite:

  • Back-link fixed /2026/08/03//2026/08/17/ (also clears the failing prose-quality broken-internal-link Vitest check).
  • File redated 2026-08-102026-08-24 so the follow-up sorts/reads after the flagship.
  • Facts synced to the rewrite: 576-page count, Ace by DAISY canonical URL.
  • Light voice pass toward the flagship's more concrete tone (named the discernible-link-text + declared-language axe checks) and linked the book's accessibility statement — this post is the "dedicated deep dive" the flagship promises.
  • Still published: false. On publish, flip to true and hyperlink the flagship's "a dedicated deep dive is coming" (line 149) to /2026/08/24/i-made-my-book-accessible/.

What

Adds a behind-the-scenes blog post: "I made my book accessible by writing it like software." It's the follow-up teased at the end of #1949 ("How I over-engineered my book") — the argument that accessibility falls out of two upfront decisions (authoring in semantic Markdown, gating the build on automated a11y checks) rather than a last-minute audit.

src/content/posts/2026-08-10-i-made-my-book-accessible.md

Draft, not live yet

  • published: false — keeps it out of listings, the feed, sitemap, OG generation, and route generation (getStaticPaths filters on isPublished) until flipped. Flip to published: true when ready to ship.
  • Dated 2026-08-10 so it reads as a follow-up to the flagship's Aug 3; adjust on publish if the real date differs.

How it relates to the flagship post

  • Links back to /2026/08/03/how-i-over-engineered-my-book/ instead of re-deriving the "wrote it like software" premise, so the two posts complement rather than repeat.
  • Ported from a private book-repo draft (benbalter/book #1965, now superseded — safe to close) and trimmed: distinct opening hook, the shared "book as build target" setup collapsed to one linked sentence.
  • Congruence fixes vs. the flagship: aligned a stray "three hundred pages" to the book's real ~576-page count, tied the 6×9 aside to the flagship's page-count check, and kept CI cadence as "every build / every release" (not "every push").

Follow-up (one manual step, intentionally deferred)

The flagship footnote forward-references this post in prose but is not hyperlinked yet — linking a live post to a published: false draft would 404. Once this merges and flips to published: true, add the reciprocal link from the flagship footnote's "getting its own post" to /2026/08/10/i-made-my-book-accessible/.

Checks

  • Vale: 0 errors, 0 AIPatterns hits. Remaining remark warnings are dictionary noise (WCAG, EPUB, reflows) and the incrementing ordered-list style used elsewhere on the blog.

🤖 Generated with Claude Code

benbalter and others added 8 commits August 3, 2026 22:50
Follow-up to "How I over-engineered my book" (PR #1949): a focused post on
how authoring the manuscript in semantic Markdown and gating every build on
axe-core/Playwright, EPUBCheck, and Ace by DAISY produces an accessible book
by default rather than via a last-minute audit.

Shipped as a draft (published: false) so it stays out of listings, the feed,
and route generation until flipped. Links back to the flagship post; ported
from a private book-repo draft and de-duplicated so the two posts complement
rather than repeat each other.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
The flagship "How I over-engineered my book" published at /2026/08/17/,
not the /2026/08/03/ this draft assumed — so update the post now that the
main post has gone through its human rewrite:

- Fix the broken back-link (/2026/08/03/ → /2026/08/17/). This also clears
  the failing prose-quality broken-internal-link Vitest check.
- Redate 2026-08-10 → 2026-08-24 so the follow-up sorts and reads as
  following the flagship, not preceding it.
- Match flagship facts: 576-page count (was "five-hundred-plus"), Ace by
  DAISY canonical URL.
- Light voice pass toward the flagship's more concrete tone: name the
  discernible-link-text and declared-language axe checks, and link the
  book's accessibility statement (this post is the "dedicated deep dive"
  the flagship promises).

Still published: false. Vale: 0 errors, 0 AIPatterns hits.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
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