Diagrams as Code

# 1. Write diagram source
nvim docs/modules/ROOT/pages/reference/diagrams/network.adoc

# 2. Build locally with Kroki
cd ~/atelier/_bibliotheca/domus-docs && make serve

# 3. Check rendered output
# http://localhost:8000/captures/reference/diagrams/network.html

# 4. Iterate until satisfied, then commit
git -C ~/atelier/_bibliotheca/domus-captures add -A && \
git -C ~/atelier/_bibliotheca/domus-captures commit -m "$(cat <<'EOF'
docs(diagrams): Add network topology diagram
EOF
)"

client -> server: HTTPS
server -> database: SQL
database: PostgreSQL {shape: cylinder}

graph LR
    client[Client] -->|HTTPS| server[Server]
    server -->|SQL| database[(PostgreSQL)]

digraph {
    rankdir=LR
    database [shape=cylinder]
    client -> server [label="HTTPS"]
    server -> database [label="SQL"]
}

@startuml
client -> server: HTTPS
server -> database: SQL
@enduml

[TOOL,target=OUTPUT_NAME,format=svg]
....
diagram source here
....

pages/reference/diagrams/
├── index.adoc          # Gallery with inline diagrams
├── architecture.adoc   # System architecture diagrams
├── network.adoc        # Network topology diagrams
├── security.adoc       # Security flow diagrams
├── flows.adoc          # Process flow diagrams
└── projects.adoc       # Project-specific diagrams