Architecture Communication
Explain the same architecture to a CEO, an engineering manager and an engineer.
20 topics in this area.
Each topic is the unit content is filed against. Topics with nothing in them yet are shown too — they are the honest edge of the curriculum rather than a gap being hidden.
Architecture Communication
General material on communicating architecture.
Architecture Diagrams
Choosing an audience and refusing to mix levels of abstraction.
No content yetC4 Model
Context, container, component and code as four separate diagrams.
No content yetContext Diagrams
The system as one box, with its users and external systems.
No content yetSequence Diagrams
Ordered message exchange, and walking the failure of each arrow.
No content yetData-Flow Diagrams
Following the data across trust boundaries rather than the calls.
No content yetDeployment Diagrams
What runs where, in which zone, behind which boundary.
No content yetCommunicating Threat Models
Making risk legible to people who will fund or accept it.
No content yetWriting Decision Records
Context, alternatives and consequences, written once and never edited.
No content yetTechnical Proposals
A written argument circulated before the decision feels made.
No content yetArchitecture Reviews
Reviewing early enough to influence rather than to veto.
No content yetPresenting to Executives
Decision first, cost, risk, and what happens if we do nothing.
No content yetPresenting to Engineers
Mechanism, alternatives rejected, and what you are unsure about.
No content yetExplaining Trade-offs
Naming what was given up, and the condition that would change it.
No content yetHandling Disagreement
Arguing from consequences, and escalating in the room.
No content yetNegotiation
Trading on interests rather than positions, with priced options.
No content yetDocumentation Practice
Keeping documents close to the code and honest about staleness.
No content yetPresentation Skills
Structure, pacing and the slide that carries the decision.
No content yetWritten Communication
Writing that survives being read without you in the room.
No content yetFacilitation
Running a design session that reaches a decision.
No content yet