Generate MyST markdown documentation from the JSON Schema definitions. Create documentation in docs/types/ with:
Generated files
- One markdown file per type (e.g.,
docs/types/Document.myst, docs/types/Heading.myst)
- Include type description, properties table, and examples
- Cross-link related types
Codegen integration
- Implement
scripts/lib/generate-docs.ts
- Register in
scripts/codegen.ts generators array
- Add
pnpm codegen docs command
Documentation structure
- Title from schema title or type name
- Description from schema description
- Properties table with name, type, required, and description columns
- Examples section if schema has examples defined
Tasks
Generate MyST markdown documentation from the JSON Schema definitions. Create documentation in
docs/types/with:Generated files
docs/types/Document.myst,docs/types/Heading.myst)Codegen integration
scripts/lib/generate-docs.tsscripts/codegen.tsgenerators arraypnpm codegen docscommandDocumentation structure
Tasks
scripts/lib/generate-docs.tsscripts/codegen.tsdocs/types/directory structurepnpm codegen docsand verify generated markdown