docs: fix stale (coming soon) markers + bring roadmap current (Cycle 19)#23
Merged
Conversation
…e 19) Correctness pass — no new page bodies, just stop DONE things claiming they're coming: - README: the developer-docs / quickstart lines said "(coming soon)" but the five docs/developers/* pages shipped in Cycle 17 — point at the live pages (overview, quickstart, API, providers, bundles). Reword the hosted-demo line so its accurate "no demo yet" status no longer reads like a broken-link/placeholder marker. - roadmap.md: the worst drift. The table stopped at Cycle 12, mislabelled Cycles 8-11 "not merged", and dropped 13-18. Rewritten to the true merged history — every cycle 0-18 shipped (PR + cycle-doc/ADR refs), the resolved voice "validation pending" hedges removed (authentic voice confirmed in Cycle 18), plus an honest "in progress / planned" section for the remaining doc work. - characters.md: wire in the produced-but-unused genie-animation.gif (shows a character in motion). Remove genie-speaking.png as redundant with genie-speaking.gif. Untouched (accurate signposts to genuine stubs): getting-started, faq, troubleshooting, voice/* — those get real content in later cycles. Docs only; no code. Links resolve, images render, CI green. Verified by code-reviewer against the actual merge history. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
A quick-win correctness pass — no new page bodies, just stop the DONE work from claiming it's "coming." Fixes the drift the audit found.
Cycle spec:
docs/cycles/cycle-19-doc-drift.md.What changed
(coming soon), but the fivedocs/developers/*pages shipped in Cycle 17. Now they point at the live overview / quickstart / API / providers / bundles pages. The "no hosted demo yet" line is reworded so its (accurate) status no longer reads like a broken-link marker.docs/roadmap.md— the worst drift: the table stopped at Cycle 12, mislabelled Cycles 8–11 "not merged", and omitted 13–18. Rewritten to the true merged history — every cycle 0–18 shown shipped (with PR + cycle-doc/ADR refs), the stale per-voice-cycle "validation pending" hedges removed (the authentic voice was confirmed end-to-end in Cycle 18), plus an honest "in progress / planned" section for the remaining doc work.docs/characters.md— wired in the produced-but-unreferencedgenie-animation.gif(a character actually in motion); removedgenie-speaking.pngas redundant withgenie-speaking.gif.Explicitly NOT touched
The genuine still-stub pages — getting-started, faq, troubleshooting, voice/overview, voice/setup, voice/sourcing-components — and their accurate
(coming soon)signposts. Those get real content in later cycles.Verification
pnpm -r typecheck && pnpm -r test && pnpm lint && pnpm format— green (docs only)..mdlink and everyimage ref resolves; the remaining(coming soon)markers all point at genuine stubs.code-reviewercross-checked the roadmap againstgit log --merges— all PR numbers correct (including the docs(legal): list speech.h as the third user-supplied file (match install pages) #19 interleave that bumps cycle-17→docs(developers): fill the five developer pages (Cycle 17) #20, cycle-18→docs(assets): Playwright capture tooling + wire screenshots/GIFs (Cycle 18) #21/docs(assets): real screenshots + GIFs of Genie running (authentic voice) #22), all ADR/cycle-doc refs exist, no DONE page claims "coming soon", scope is docs-only.Base
main, not merged.🤖 Generated with Claude Code