Technical documentation
Technical teams use Capable Diagrams to explain how systems, services, data flows and infrastructure fit together.
These diagrams make technical context easier to understand for engineers, architects, product managers, support teams and stakeholders.
#Typical scenarios
#System context diagrams
Show users, products, services and external systems.
#Architecture diagrams
Applications, platforms, integrations, cloud infrastructure or data pipelines.
#Sequence diagrams
Explain how systems interact during key transactions or incidents.
#Network and deployment diagrams
Document environments, regions, dependencies and ownership.
#Other diagrams
Runbooks, design decisions, implementation plans and support documentation.

#How teams use it
Architects sketch high-level system context before moving into detailed service or deployment views
Engineers use diagrams in design pages to explain proposed changes before implementation
Support and operations teams use architecture diagrams to understand dependencies during incidents
Best practice: Keep different levels of detail separate. Use one diagram for the system context, another for component detail, and another for deployment or runtime behaviour.
#Why Capable Diagrams helps here
Gives technical pages a visual entry point before readers go into detailed design notes
Helps teams review architecture decisions and spot missing dependencies
Supports common technical formats such as Mermaid, PlantUML, C4-style modelling and visual sketching
Makes diagrams part of Confluence documentation instead of separate files that go stale
