PlantUML (.puml) is the source of truth for the user-facing architecture pictures. Maven renders them to committed SVGs under ../images/diagrams/ so AsciiDoc preview and GitHub show images — no Mermaid license, and no Markdown fences in .adoc files.

Use !pragma layout smetana in every file so Graphviz is not required.

edw-overview.svg is a hand-laid poster under docs/images/diagrams/. The rows are positioned by hand, so it has no .puml and mvn generate-resources leaves it alone.

Files

Source Used from

edw-overview.svg

Getting started — overview, Architecture — overview

d1-logical-layers.puml

architecture D1, feature-overview

d2-catalog-bus.puml

architecture D2

d3-rdg-spine.puml

architecture D3

d4-build-vs-run.puml

architecture D4

d5-four-controls.puml

architecture D5

d6-grow-the-warehouse.puml

architecture D6

bv-raw-vault-relationship.puml

business-vault-overview

bv-pit-scd2.puml

business-vault-pit

bv-identity-cutover-survivorship.puml

business-vault-scd2

identity-cutover-survivorship-infographic.html

business-vault-scd2, embedded infographic

bv-identity-map-freeze.puml

business-vault-scd2, bv-identity-map-dialog

bv-source-cutover-calendar.puml

business-vault-scd2, bv-source-calendar-dialog

bv-survivorship-rules.puml

business-vault-scd2

enterprise-people-files-systems.puml

enterprise-modeling-and-team-collaboration

Render locally or via Maven

Maven (generate-resources) writes SVGs next to the screenshots:

mvn generate-resources

Or with a PlantUML jar (same version as plantuml.version in the root pom.xml):

java -jar plantuml.jar -tsvg -o ../images/diagrams .

Commit both the .puml change and the updated .svg.