Skip to content

docs(router): warm intros of the 11 light-touch docs - #550

Merged
ivogt merged 1 commit into
mainfrom
docs/warm-voice-light-touch
Jun 8, 2026
Merged

ivogt merged 1 commit into
mainfrom
docs/warm-voice-light-touch

Conversation

@ivogt

@ivogt ivogt commented Jun 8, 2026

Copy link
Copy Markdown
Collaborator

What

Intro/framing warming for the 11 light-touch docs — a reader-facing opener that orients you before the spec begins, in the AGENTS.md "Documentation voice". Bodies are untouched on purpose (the dense/factual content is where fabrication risk lives, per the lesson from the agent-rewrite experiment in #549). Docs-only, [skip ci].

Docs touched: caching, mime-routes, named-routes, client-chunking, is-action-api-design, ssr-streaming-policy, prerender-api-design, react-compiler, telemetry, tree-structure, consolidate-gen-files.

Net diff is small (52 insertions / 6 deletions) — these are openers, not rewrites.

Notes

  • client-chunking: fixed a "Honest chunk names" heading (line 207) → "Chunk names that match reality" — the standing no-"honest" rule. (Capital H is why an earlier lowercase grep missed it.)
  • Hand-authored (no agents on doc prose) and scanned for the markdown +-wrap hazard and any remaining "honest".

Test plan

  • Docs only; format clean; [skip ci].
  • No "honest" and no +/* line-start wrap hazards in the changed docs.

This is the second of the doc-voice tranche: #549 did the 9 "why" docs; this does the 11 light-touch. Still parked: the 18 stale archive-candidates (separate move-to-archive/ PR, coming next).

@ivogt ivogt mentioned this pull request Jun 8, 2026
2 tasks done
@ivogt
ivogt merged commit cd29a23 into main Jun 8, 2026
@ivogt
ivogt deleted the docs/warm-voice-light-touch branch June 8, 2026 19:05
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