Context
Architecture and transaction-flow pages need diagrams, and diagrams drawn in
image editors go stale because nobody can edit them. Mermaid in a fenced block
is reviewable in a diff. Rendering it at build time keeps the client library out
of the bundle.
Scope
- Render ```mermaid fences to inline SVG at build time; no client-side Mermaid.
- Theme the output from design tokens and emit both theme variants, switched by
CSS like code blocks (DX-035).
- Every diagram carries an accessible name and description, authored via a
required caption — a diagram with no text alternative fails the build.
- Wide diagrams scroll inside their own container.
- A malformed diagram fails the build with the file and the parser error.
Acceptance criteria
Out of scope
- Interactive or zoomable diagrams.
Spec: docs/dx_1/001_docs_site.md §4 · Depends on: DX-053
Context
Architecture and transaction-flow pages need diagrams, and diagrams drawn in
image editors go stale because nobody can edit them. Mermaid in a fenced block
is reviewable in a diff. Rendering it at build time keeps the client library out
of the bundle.
Scope
CSS like code blocks (DX-035).
required caption — a diagram with no text alternative fails the build.
Acceptance criteria
Out of scope
Spec:
docs/dx_1/001_docs_site.md§4 · Depends on: DX-053