Distillation

Date: Jul 30, 2026

• 🟡 (20:47) User requested landing page refinements: drop TRDIFF10 references (or use once), remove duplication of "the catch"/"how an update flows", drop "skip it when" section, fully drop "how an update flows" + diagram from landing and move to a docs page, revise/remove "CI minutes" card (inaccurate — adding minutes for patch gen), reorder "When to reach for binpatch" right after "What you save"
• 🟡 (20:48) Investigation: read website/src/content/docs/index.mdx — confirmed "The catch" appears at lines 48-75 AND lines 131-148 (duplicated). "How an update flows" appears at lines 67-75 (with flow.svg) AND lines 150-162 (with mermaid). TRDIFF10 mentions: line 3 (description), line 104 (Electron section), line 154 (mermaid node). "Skip it when" at lines 126-129. "CI minutes" card at lines 37-41
• 🟡 (20:48) Investigation: checked docs pages — github-action.md is the best fit for the flow diagram (it describes the end-to-end CI→patch→registry→user flow). Architecture.md already has architecture-flow.svg. Getting-started.md is API-focused
• 🔴 (20:48) User-stated architecture facts observed in architecture.md (re-stated as preferences/directives in current session, NOT to be acted on this turn): library never reads config files (cache dir injected via makeCache), library never renders progress (consumers plug in own indicator)
• 🟡 (20:49) Refactor applied to website/src/content/docs/index.mdx: removed duplicate "The catch" + "How an update flows" sections (first copy at lines 48-75 dropped, second copy at lines 131-162 dropped entirely), removed "Skip it when" (lines 126-129), removed "CI minutes" card (kept Bandwidth, Wall time, User patience — 3 cards), updated description to drop TRDIFF10, updated Electron Tabs to drop TRDIFF10 mention. Final structure: Hero → chart → What you save (3 cards) → When to reach for binpatch (4 Tabs) → The catch → Get started
• 🟡 (20:49) Refactor applied to website/src/content/docs/github-action.md: added mermaid "How an update flows" diagram as new section after intro, before "What it does" table. Diagram shows: CI build → bsdiff+zstd → Patch → publish → Registry (GHCR/GitHub Releases) → discover → Updater → download chain (parallel hops) → apply + SHA-256 verify → Verified new binary
• 🟡 (20:49) Build verification: 16 HTML files built in 4.04s, 0 bad links across 1004 links/236 files
• 🟡 (20:49) Commit f75850b "docs(website): trim landing page; move flow diagram to github-action page" — 2 files changed, 23 insertions, 59 deletions. Pushed cdfcc07..f75850b to docs/any-binary-rebrand-v3 branch
• 🟡 (20:51) CI green on f75850b: preview pass (23s, run 30580870986/job/91000485362), test pass (16s, run 30580870980/job/91000485096), Build skipping (gh-pages deploy, expected). PR #36 preview at https://binpatch.p.byk.im/_preview/pr-36/