Conceptual Diagram Block
Embed conceptual diagrams for domain modelling and relationship mapping. Illustrate high-level domain concepts and their relationships without implementation detail.
Conceptual diagram blocks embed domain-level diagrams directly into your documentation pages. These diagrams focus on high-level concepts and their relationships, deliberately omitting implementation details such as data types, foreign keys, or infrastructure concerns. They are ideal for communicating domain boundaries, concept hierarchies, and relationship semantics to both technical and non-technical audiences.
When to Use
Block Properties
| Property | Required | Description |
|---|---|---|
| Diagram Path | Yes | Path to the .diagram.json file containing the conceptual diagram |
| Title | No | Optional title displayed above the diagram |
Key Characteristics
Conceptual vs Standard Diagram Block
| Aspect | Conceptual Diagram | Standard Diagram |
|---|---|---|
| Audience | Business and technical stakeholders | Primarily technical teams |
| Detail Level | Abstract concepts and relationships | Implementation-level shapes and connections |
| Data Types | Not shown | Shown where relevant |
| Best For | Domain discovery and communication | Technical architecture reference |