Iii Doc Authoring

iii-doc-authoring

How to write Mintlify-shaped .md / .mdx docs that iii-skill-check validates and renders into per-doc skill artifacts (<source>.skill.md siblings).

Read individual topics directly via skillkit read iii-doc-authoring/<topic>.

Topics

• quickstart: minimum viable docs project: .skill-check.yaml, frontmatter, the verify command.
• frontmatter: required and optional fields; how type: drives voice rules.
• types: short summary of which Vale and AI rules each Diataxis category enables.
• markers: <!-- skill:... --> HTML-comment markers for opting docs in/out and including/excluding sections.
• voice: pointer to project-rules/voice.md plus per-type call-outs.
• llm-only-blocks: when to wrap content visible only to AI consumers.
• check: running iii-skill-check verify locally on a docs root.

Authoring guides per Diataxis quadrant

These five files are skillkit-shape skills (their frontmatter uses name: + description: instead of the Mintlify shape the validator looks for, and they're excluded from the docs-mode pipeline). Load doc_workflow once for any docs work, plus the quadrant-specific file that matches the page you're writing.

• diataxis/doc_workflow: global tone, component usage, quadrant integrity, structural rules. Always loaded.
• diataxis/doc_tutorial: learning-oriented authoring rules.
• diataxis/doc_howto: problem-oriented authoring rules.
• diataxis/doc_reference: information-oriented authoring rules.
• diataxis/doc_explanation: understanding-oriented authoring rules.

The runtime Vale config is generated per-run from each doc's frontmatter type:. Diataxis rules apply to the right artifacts without depending on directory layout.

This bundle is not itself a worker. There is no iii.worker.yaml, no rendering step. The markdown files in this directory are the source of truth.