Diagram Blocks
Reference for the diagram category blocks: Diagram with linked presentation discovery, Presentation Diagram with step playback, Graph Diagram, and Trade-off Matrix.
The Diagrams category includes blocks for embedding architecture diagrams, animated presentations, and decision matrices in documentation pages.
Diagram Block
Embeds architecture and flow diagrams created in the diagram editor. Automatically discovers and displays linked presentations from sibling .presentation.json files.
| Property | Type | Description |
|---|---|---|
| diagramId | string | Reference to .diagram.json file |
| diagramFileName | string | Auto-populated file name |
Presentation Diagram Block
Embeds standalone animated presentations with built-in step navigation controls.
| Property | Type | Description |
|---|---|---|
| presentationId | string | Reference to .presentation.json file |
| presentationFileName | string | Auto-populated file name |
Graph Diagram Block
Embeds D3 force-directed graph diagrams for visualising relationships.
| Property | Type | Description |
|---|---|---|
| graphDiagramId | string | Reference to .graph-diagram.json file |
| graphDiagramFileName | string | Auto-populated file name |
Trade-off Matrix Block
Decision matrix for comparing options across multiple criteria.
| Property | Type | Description |
|---|---|---|
| title | string | Matrix title (required) |
| status | enum | Status: exploratory, recommended, decided, deprecated |
| options | array | Array of options to compare (required) |
| rationale | string | Why the decision was made |