docs: final review fixes — deferred backlog, doc accuracy, sample-data note
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
dd106c5d0e
commit
2ff58ace46
11 files changed
+103
-37
No files matched your search
+44
-3
@@ -4,7 +4,7 @@ Durable backlog. Agents append here instead of leaving `TODO` comments in source
|
||||
Small, specific, independently actionable. Remove only when actually done.
|
||||
|
||||
## Now
|
||||
- [ ] Verify every `// TODO(verify)` field in `src/data/sample.ts` (48 at bootstrap: saga names, singers,
|
||||
- [ ] Verify every `// TODO(verify)` field in `src/data/sample.ts` (56 after final review: saga names, singers,
|
||||
story times, Odyssey book/lines, motif descriptions, facts) before any content leaves mockup stage.
|
||||
|
||||
## Next
|
||||
@@ -39,5 +39,46 @@ Small, specific, independently actionable. Remove only when actually done.
|
||||
- [ ] Two mockups with byte-identical `style.css` fail `bun run build` with "Multiple files share the same
|
||||
output path" (reproduced by copying `01-editorial/style.css` over `02-vertical-story/style.css`).
|
||||
Identical `main.ts` files do not trigger it.
|
||||
- [ ] `docs/plans/001-timeline-mockups.md` tells mockup agents to start `bun dist/server.js`, which hits
|
||||
the issue above; use `bun run start` instead.
|
||||
|
||||
## Deferred from final review (2026-10-23)
|
||||
|
||||
### Shared / foundation
|
||||
- [ ] `src/server.ts`: routes are hand-listed; generate them from `src/mockups/registry.ts` (see Someday).
|
||||
|
||||
### Docs / permissions
|
||||
- [ ] `docs/DECISIONS.md`: entries are oldest-first; the template is newest-first. Pick one.
|
||||
- [ ] `AGENTS.md`: the architecture map duplicates `docs/ARCHITECTURE.md`; trim one.
|
||||
- [ ] `docs/plans/README.md`: says "feature branch" while branching is still `TODO(maintainer)`.
|
||||
|
||||
### Sample data
|
||||
- [ ] `src/data/sample.ts`: `odyssey.url` points at Butler's prose translation, so "lines X-Y" will not match the linked text; switch to book/chapter references or a lineated edition when verifying.
|
||||
|
||||
### Mockup 01 editorial
|
||||
- [ ] `src/mockups/01-editorial/style.css`: credit footer clips at about 761-1068px width with the folio open (parked; spec targets desktop 1440x900).
|
||||
|
||||
### Mockup 02 vertical story
|
||||
- [ ] `src/mockups/02-vertical-story/main.ts`: `frame()` interleaves layout reads and writes.
|
||||
- [ ] `src/mockups/02-vertical-story/style.css`: saga marker padding inflates boundary gaps; `.sea` background snaps between sagas.
|
||||
|
||||
### Mockup 03 transit map
|
||||
- [ ] `src/mockups/03-transit-map/main.ts`: ruler repeat label reads "Year 0" for fall-of-Troy songs.
|
||||
- [ ] `src/mockups/03-transit-map/main.ts`: `--footer-h` is not re-measured after fonts load.
|
||||
|
||||
### Mockup 04 greek frieze
|
||||
- [ ] `src/mockups/04-greek-frieze/main.ts`: post-drag click-swallow listener can stay armed if no click fires.
|
||||
|
||||
### Mockup 05 score
|
||||
- [ ] `src/mockups/05-score/main.ts`: `.part.is-cued` is not cleared on song change or close.
|
||||
- [ ] `src/mockups/05-score/main.ts`: chip click re-renders the panel, which would restart the MP3.
|
||||
- [ ] `src/mockups/05-score/main.ts`: `has-song` class is unused.
|
||||
|
||||
### Mockup 06 constellation
|
||||
- [ ] `src/mockups/06-constellation/`: per-frame `Vector3` allocations; constructor failure leaks the canvas; WebGL probe context is not released.
|
||||
- [ ] `src/mockups/06-constellation/`: label box cache goes stale on resize; Enter on the credits link opens a song.
|
||||
- [ ] `src/mockups/06-constellation/`: fallback ruler is inert; legend/panel overflow; Troy saga caption is clipped.
|
||||
- [ ] `src/mockups/06-constellation/`: check intro flight and easing in a real browser (unverifiable headless).
|
||||
|
||||
### Mockup 07 sea voyage
|
||||
- [ ] `src/mockups/07-sea-voyage/`: per-frame `Color`/`Vector3` allocations; WebGL probe context is not released.
|
||||
- [ ] `src/mockups/07-sea-voyage/`: no `webglcontextlost` handler; DPR is read once.
|
||||
- [ ] `src/mockups/07-sea-voyage/`: waypoint tag `innerHTML` is unescaped; drawer clips the "The open sea" label.
|
||||
Reference in new issue
Block a user