Competencies: Documentation > Diagramming

Diagramming Fundamentals

Diagram types (architecture, sequence, flow, ER), visual hierarchy, layout principles.

High

Architect, Technical Writer

D2

Declarative diagramming, connections, containers, styles, themes, animations.

Medium

Technical Writer, Architect

Mermaid

Markdown-friendly diagrams, flowcharts, sequence, ER, Gantt, GitHub/GitLab rendering.

High

Developer, Technical Writer

PlantUML

UML diagrams, sequence, class, activity, component, wide tool integration.

High

Architect, Developer

Graphviz (DOT)

Graph visualization, automatic layout, programmatic generation, large graph handling.

Medium

Developer, Data Engineer

C4 Model

Context, Containers, Components, Code diagrams, architecture documentation, Structurizr.

High

Software Architect, Technical Writer

Excalidraw/Draw.io

Freeform diagramming, whiteboard-style, collaborative editing, export formats.

Medium

All Engineering

Kroki

Diagram rendering service, multi-format support, documentation integration.

Medium

Documentation Engineer

Architecture Decision Records

ADRs, decision capture, templates, lightweight documentation, Markdown ADRs.

High

Architect, Technical Lead

Network Diagrams

Topology visualization, Visio/Lucidchart, IP addressing diagrams, rack diagrams.

High

Network Engineer, Systems Administrator

D2 Diagrams

Advanced

Architecture diagrams, network topologies, flow charts; Kroki integration for Antora build; D2 syntax for connections, containers, styles

D2 Diagramming Reference

No animated D2, no D2 theming beyond defaults, no Mermaid/PlantUML cross-tool fluency