Skip to content

docs(tutorials): chat series typed-route + honesty-callout quality pass#681

Merged
rickylabs merged 1 commit into
mainfrom
docs/661-chat-quality
Jul 11, 2026
Merged

docs(tutorials): chat series typed-route + honesty-callout quality pass#681
rickylabs merged 1 commit into
mainfrom
docs/661-chat-quality

Conversation

@rickylabs

Copy link
Copy Markdown
Owner

Refs #661 (chat-series rollout slice)

CHAT series + durable-chat callouts per the audit spec: identical raw-Request honesty callout in the three stream-proxy pages (proposal 4); shared contracts/routes/chat-turn.ts route contract with chatTurnRoute.href({ path: { sessionId } }) replacing template-string URLs in ch03/ch06 (proposal 5); ch02 shows the dynamic [sessionId] route typed via .parsePath; honest "why not useIslandQuery for the transcript" scoping note in ch03; chat index lede names the differentiator + contrast sentence (proposal 17).

Validation: docs verify green — 169 pages / 23,454 links; grep gate 0 hits on all 6 touched files; APIs verified via deno doc + scratch check (worklog in-branch at .llm/runs/docs-661b-chat--opus/).

Authored by a Claude Opus 4.8 docs agent under the beta-8 orchestrator (4d300496); Tier-A reviewed.

- Proposal #4: identical raw-Request stream-proxy exception callout in chat/02,
  how-to/build-a-durable-chat, ai/durable-chat.
- Proposal #5: bind the turn POST URL to a shared createRouteReference contract
  (contracts/routes/chat-turn.ts) in chat/03 + chat/06.
- Matrix: show the dynamic [sessionId] route typed in chat/02; honest
  useIslandQuery-scope note in chat/03.
- Proposal #17: chat index lede names the differentiator + contrast sentence.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VifzAytcxBk5odEMaCXihM
@rickylabs rickylabs added this to the 0.0.1-beta.8 milestone Jul 11, 2026
@rickylabs rickylabs added area:docs status:impl-eval type:docs priority:p1 High epic:docs-cut beta.7 docs release cut epic (tutorials + positioning) labels Jul 11, 2026
@rickylabs
rickylabs marked this pull request as ready for review July 11, 2026 22:27
@rickylabs
rickylabs merged commit fdc2b06 into main Jul 11, 2026
12 of 14 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:docs epic:docs-cut beta.7 docs release cut epic (tutorials + positioning) priority:p1 High status:impl-eval type:docs

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant