Skip to content

Phase 9: docs, landing page and launch assets - #6

Merged
deaneeth merged 2 commits into
mainfrom
feat/phase-9-launch
Oct 26, 2026
Merged

deaneeth merged 2 commits into
mainfrom
feat/phase-9-launch

Conversation

@deaneeth

Copy link
Copy Markdown
Member

Summary

Phase 9: docs, landing page and launch assets.

  • Landing page: an animated FLASH schedule for N = 16 on a causal mask, the three claims, and links to the visualizer and the docs.
  • Six docs pages with live demos: what attention computes (float reference), the online softmax (an engine run recorded tile by tile), the FlashAttention traffic (generated table), fixed point (an INT8 quantizer and the measured error), the architecture diagram, and verification (each check with its command, and the measured tables).
  • Generated data: web/src/lib/measured.ts comes from the golden model, the recorded 1000-seed study and the N = 32 cycle baselines. pytest sim/golden fails if it is stale.
  • Launch assets: /og social card (1200 × 630), captured to web/public/og.png; screenshot to docs/media/visualizer.png; og and twitter meta tags.
  • README rewritten for the series, with the verification table and the measured numbers.

No RTL changes.

Verification

  • pytest sim/golden: 54 passed (including the freshness checks for every generated file).
  • node wasm/test.mjs: PASS.
  • pnpm lint, pnpm typecheck, pnpm build: clean.
  • pnpm test (Vitest): 15 passed.
  • pnpm test:e2e (Playwright, production build): 35 passed. Covers every page (status, no console errors, islands render, demos respond) and every page at 375 px.

Not in this PR

  • FPGA synthesis (Phase 10). The README and the Verification page say so; no timing or area numbers are claimed.
  • Deployment is a separate step after merge.

- Landing page with the animated FLASH schedule (N = 16, causal), the three claims, and links to the visualizer and docs.
- Six docs pages with live demos: what attention computes (float), the online softmax (engine run recorded tile by tile),
  the FlashAttention traffic (generated table), fixed point (INT8 quantizer, measured error), the architecture diagram,
  and verification (each check with its command, and the measured tables). Plus a docs index.
- Generated web/src/lib/measured.ts from the golden model, the recorded 1000-seed study and the N = 32 cycle baselines;
  pytest fails if it or the other generated tables are stale.
- Social card at /og (1200 x 630) captured to web/public/og.png; screenshot to docs/media/visualizer.png; og and twitter
  meta tags in the layout.
- README rewritten for the series: live link, verification table with the measured numbers, repository map, quick start.
- Browser tests for every page (status, no console errors, islands render, demos respond) and every page at 375 px.
- --line colour token added to both themes. Docs tables scroll inside their own box on phones.
…le across BLAS builds

CI's golden test failed on the last digits of maxErr (float64 summation order differs between machines).
The docs show four decimals; rounding to six makes the generated file platform-independent.
@deaneeth
deaneeth merged commit da651e4 into main Oct 26, 2026
4 checks passed
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