# Software and architecture

Software diagrams have one failure mode above all others: they are drawn for a review, approved, and then never opened again. Every recommendation here is biased towards diagrams that are cheap to change, because a diagram that is cheap to change is one that stays true.

Where a text language will do the job, use it. Keep the canvas for diagrams where position genuinely carries meaning.

---

## In this section

[UML diagramsThe UML diagram types you can draw in Confluence today, with the recommended language for each one.](https://help.gocapable.com/diagrams/uml-diagrams.html)[C4 modelDocument architecture with the C4 model and choose between C4-PlantUML and the Structurizr DSL.](https://help.gocapable.com/diagrams/c4-model.html)[Software architecture diagramDraw a software architecture diagram in Confluence and keep it versioned with the page it documents.](https://help.gocapable.com/diagrams/software-architecture-diagram.html)[Microservices architectureDiagram service boundaries, queues, databases, and synchronous versus asynchronous calls.](https://help.gocapable.com/diagrams/microservices-architecture.html)[Dependency graphRender a dependency graph from DOT for package trees, service call graphs or build pipelines.](https://help.gocapable.com/diagrams/dependency-graph.html)[Git branching diagramDraw a git branching diagram to explain your branching model, releases, merges and cherry picks.](https://help.gocapable.com/diagrams/git-branching-diagram.html)[Requirements diagramLink requirements to the elements that satisfy and verify them in a SysML style requirements diagram.](https://help.gocapable.com/diagrams/requirements-diagram.html)[Event modelingLay out an event model with commands, events, read models and the timeline that connects them.](https://help.gocapable.com/diagrams/event-modeling.html)[ArchiMate diagramDraw ArchiMate enterprise architecture views in Confluence using the shipped ArchiMate shapes and stdlib.](https://help.gocapable.com/diagrams/archimate-diagram.html)[Block diagramDraw a block diagram of boxes and arrows in Confluence, from text or on a canvas.](https://help.gocapable.com/diagrams/block-diagram.html)

---

_Cheap to change means it stays true._