documentation

name: documentation description: | Use when editing `docs/**/*.mdx`, generated reference docs, TypeDoc comments, `typedoc.json`, `docs/docs.yml`, or documentation review instructions. last_verified: 2026-05-06

aa-sdk documentation is MDX under docs/, with committed TypeDoc reference output under docs/pages/reference/ and navigation in docs/docs.yml.

Rule	When to read
MDX code preservation	Before editing docs code snippets.
TypeDoc reference generation	Before changing reference docs or TSDoc.
docs.yml navigation	Before changing docs navigation or reference nav generation.

typedoc.json writes .mdx output to docs/pages/reference.
scripts/generate-typedoc-yaml.ts scans reference MDX and updates docs/docs.yml.
Existing .claude, .cursor, and .github docs instructions emphasize code snippet preservation.