Public Docs

Use this workflow to produce docs that are crisp, task-oriented, and trustworthy for external users.

Load only the references needed for the request:

Task	Read
Understand docs app layout and constraints	`references/api-surface.md`
Draft or revise common docs pages	`references/common-use-cases.md`
Diagnose docs quality/build failures	`references/troubleshooting-workarounds.md`

Core invariants

Keep docs audience-facing: explain user outcomes, not internal implementation chatter.
Match the local docs contract in packages/docs/src/content/docs/contribute/documentation-guidelines.md.
For new or substantially edited pages, require frontmatter fields: type, summary, prerequisites, related.
Include concrete verification steps for tutorial/troubleshooting content.
End each page with an explicit "next step" path through internal links.