---
id: doc-schema
kind: topic
title: "Documentation schema"
atlas_url: https://designsystems.fly.dev/nodes/doc-schema.md
---

# Documentation schema

An open, machine-readable format for design system documentation, with typed entries, audience-aware sections, links to authoritative source files and testable conformance rules for humans, parsers and agents.

Documentation is the top current AI use (60%) and the top AI wish (57%) (zeroheight, n=147)

## Edges

- <- about <- A Design Tokens Workflow (Part 17) - How Colour Works with the DTCG Design Tokens Color Module, AI is accidentally making documentation more accessible, Architecture, Not Documentation, Building an AI-Ready design system, Component Contracts and Schemas, Design System Doc Spec 0.20.0, Design System Documentation Community Group (proposed), Design System Office Hours, Design Systems Course, Design Systems News, issue 221, Design Systems Report 2026, Design Systems for the Machines: How to Make AI Understand Your UI, Design Tokens Format Module 2025.10, Design system documentation as structured metadata, Design system documentation is essential–as long as it’s good, Design systems are contracts, not libraries, Design systems as knowledge graphs, Documentation foundations for humans and AI, From Pipeline to Governed Artifacts, Generation is not verification, I’m making a spec for design system documentation, Learning Agentic Design Systems, Machine-Readable Design Systems for MCP and LLMs, Making product documentation work for humans and AI, Probabilistic isn’t a dirty word…, Specs Stop at the Component. Governance Doesn't., Use AI to Need Less AI, Your documentation is still in your Mum's filing cabinet, Your next design system user
- <- focus <- Anna E. Cook, Cassie Groos, Chase McCoy, Cristian Morales Achiardi, Davy Fung, Diana Wolosin, Donna Vitan, Drew Powers, Geri Reid, James Nash, Jennifer Wjertzoch, Josef Richter, Kathleen McMahon, Louis Chenais, Matthew Ström-Awn, Mike Kamminga, Murphy Trueman, Nathan Curtis, PJ Onori, Robin Di Capua, Shane P Williams, Sil Bormüller, Stuart Robson, TJ Pitre, Tina Singh
- <- ships <- Atlassian Design System, Design System Doc Spec (DSDS), Design System Documentation Community Group, Design Systems News, Design Tokens Format Module, Knapsack, Supernova

## Sources

- https://www.w3.org/community/blog/2026/07/30/proposed-group-design-system-documentation-community-group/
- https://github.com/somerandomdude/design-system-documentation-schema/blob/main/CHANGELOG
- https://report.zeroheight.com/