Handbook
Documentation design system
The Markdown files in this folder are normative for LCDL handbook UX. They apply to narrative docs under docs/ and to how those pages are expected to render on the static site built by forge-lcdl-website.
Updated
| Document | Purpose |
|---|---|
| lcdl-human-first-ia.md | Reader intents and canonical information architecture |
| lcdl-navigation-shell.md | Horizontal nav + active-section sidebar behavior |
| lcdl-page-layout-taxonomy.md | layout_type values and page anatomy |
| lcdl-rich-components.md | Preferred Kitchen Sink components and anti-patterns |
| lcdl-hero-and-messaging.md | Homepage and section messaging patterns |
| lcdl-diagram-system.md | Diagram catalog, alt text, and fallbacks |
| lcdl-enterprise-trust-patterns.md | Enterprise tone and trust blocks |
Hard rules
- Do not expose contract HTML pages or flat dumps of every generated page in primary navigation.
- Avoid global flat sidebars that list the entire tree; navigation should follow lcdl-navigation-shell.md.
- Respect context budgets in lcdl-page-layout-taxonomy.md; use
longform_ok: truein frontmatter only when a page must exceed its budget.