Skip to content

ADR-0012: Rich artifacts hang off the markdown spine

ADR-0012: Rich artifacts hang off the markdown spine

Status: accepted (carried; the Book machinery in apps/book implements it)

Book pages are not limited to prose: Mermaid diagrams, tables, and standalone HTML explainers (served from apps/book/public/explainers/) are first-class. Every rich artifact has a searchable markdown page as its canonical, navigable unit — diagrams render inline; standalone HTML is linked from its paired page. Courses are authored in docs/domain-knowledge/course-* and copied to the site at build time.