docs: Phase 5 — v8 README, migration guide, deploy recipes, RFC draft

README rewritten for the v8 branch: honest size claim (7.97 kB min+gzip
for the whole framework, with the v7 '4kb' context), the zero-build
story up front, bankai v10, package map, credits to yoshuawuyts, the
choojs contributors and the pirxpilot fork line.

docs/migrating-v7-to-v8.md: the codemod path, the specifier map, and
every deliberate behavior change spelled out. docs/deploy.md: plain
Node, Docker, proxy/CDN — including the HTTP/3 answer (h3 is
infrastructure's job; bankai's contract is the 103 + Link headers that
any hints-aware edge, h3 included, propagates; server push is dead
everywhere and never existed in h3) — and web-standard runtimes.

docs/rfc.md: the draft announcement for choojs/choo — continuation
framing, pings to yoshuawuyts and pirxpilot, the npm-rights ask, API
feedback questions, and a three-week comment window with a
silence-is-consent close.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014NgfSjHE11oFpoSnLVKLXd
This commit is contained in:
Bendik Aagaard Lynghaug
2026-09-08 19:41:22 +02:00
co-authored by Claude Fable 5
parent 99f9da1e3b
commit b957b02410
5 changed files with 340 additions and 668 deletions
+17 -5
View File
@@ -108,11 +108,23 @@ Server string rendering is on par with nanohtml v1 (~13k ops/s, within
All proven end-to-end in real Chromium: both dev and prod pages
hydrate with zero console errors and zero mismatch warnings, and
the 103 interim response is asserted at the HTTP level.
- [ ] Phase 4 follow-ups: HTTP/2 dev server with local certs (browsers
only act on Early Hints over h2/h3), static prerender of
enumerable routes, SSR `<title>` from state (needs a head hook in
toStream), edge-runtime deploy recipe (`new Response(toStream())`
— the server core is already web-standard).
- [x] Phase 4 follow-ups: `bankai serve --h2` (local certs via openssl,
103 verified with a real h2 client), `bankai build --prerender`,
SSR `<title>` from state (the server reads the first stream chunk
before writing the head), the `style.css` convention (client-only
CSS — the sheetify answer), and the CI wire-size budget
(`npm run size`: 7.97 kB min+gzip for the whole framework,
budget 8.5 kB).
- [x] Phase 5: README rewritten for v8 (honest size claim, credits),
`docs/migrating-v7-to-v8.md`, `docs/deploy.md` (Node, Docker,
proxy/CDN with the HTTP/3 story — h3 is infrastructure's job,
bankai's contract is the 103 + Link headers any hints-aware edge
propagates — and web-standard runtimes), and `docs/rfc.md`: the
draft announcement to post on choojs/choo, with the pings, the
asks, and the three-week comment window.
- [ ] Post-RFC: publish pre-releases under a next tag, refresh
choo.io/handbook (separate repos), deprecation pointers on retired
packages only after 8.0.0, first-class edge adapter for bankai.
- [ ] Phase 4: bankai v10 (Vite 8/Rolldown shell, SSR middleware,
103 Early Hints, service worker, precompression)
- [ ] Phase 5: docs, examples, launch