Repository navigation
Redesign the docs homepage as an interactive protocol walkthrough - #524
Merged
Merged
Conversation
Connor Peet (connor4312)
enabled auto-merge (squash)
October 12, 2026 20:04
Introduce the selected seven-chapter device walkthrough with reducer-backed chat, reconnect, automation, terminal and capability examples. Share accessible theme tokens across the notebook and documentation, and cover model behavior and palette contrast with focused tests. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
- Drop the masthead, cover eyebrow, tagline and stage navigation. - Restructure the story into four chapters: actions + state = ui, reconnect and replay, an extensibility showcase (automations, terminals, capabilities) and client libraries. - Rewrite copy to focus on why AHP exists rather than sequence bookkeeping, and add short explainers to each message list. - Center the cover with a peek of the first chapter; hide the stage caption on the cover; pin the stage to the bottom on mobile. - Syntax-highlight wire JSON and quiet the collapsed message toggles. - Update the reconciliation guide's homepage description. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Remove the stage caption/inset footer and chapter kickers, shorten in-device labels, restyle device frames and the host rail for both themes, keep newest chat content visible on small screens, and drop the unused HomeWalkthrough component. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Connor Peet (connor4312)
force-pushed
the
docs/notebook-homepage
branch
from
October 26, 2026 19:27
2d898b8 to
3a898a2
Compare
roblourens
approved these changes
Oct 26, 2026
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
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.
Replaces the docs homepage with a scroll-driven walkthrough that shows why AHP exists. Simulated devices (desktop, tablet and phone) stay in sync through one host, driven by the canonical reducers.
What's on the page
chat/turnStarted, shows it as pending, and the host's broadcast keeps every client in sync.Each step has an expandable message list with syntax-highlighted JSON, a short explanation of the protocol detail it shows, and a state diff where relevant. Everything runs locally in the browser; there's no network access and no model.
Layout and theme
Tests
scripts/homepage-notebook*.test.tschecks that the scripted model converges through the real reducers, that navigation is deterministic, and that devices don't overlap the host rail.scripts/site-theme.test.tschecks palette contrast and that components only use shared colour tokens.No protocol surface changes, so there's no changelog fragment.