Architecture, drawn out
Helping teams design software systems that survive real-world complexity.
A diagram-native publication on software architecture — the systems, the trade-offs, and the diagrams that make them legible.
Featured articles
All articles- Software Architecture3 min read
Software Architecture is a Characteristic, Not a Discipline
Software Architecture is used as a term, most often, attributed to something different from Software Development, as if, it is separate from the coding process. However, it isn't separate, but an integral part of software; a piece so integral to quality software. It's a characteristic, not a discipline.
- Software Architecture
- Engineering
- Experience
- C# & .NET7 min read
I or No I, and the Naming of Interfaces
An opinion on why the "I" prefix convention for C# interfaces exists, where it causes harm, and what better naming discipline actually looks like in practice.
- csharp
- interfaces
- dotnet
- code-quality
- C# & .NET8 min read
.NET DI — Service Assignment
Three progressively better approaches to injecting specific interface implementations into particular services using ActivatorUtilities, without registering concrete types in the DI container.
- dotnet
- dependency-injection
- csharp
- design-patterns
Featured diagrams
All diagrams
IntegrationEvent-driven integration
A producer publishes to a broker topic that fans out to independent consumers, with a dead-letter queue for poison messages.
- events
- messaging
- decoupling
Multi-TenantMulti-tenant isolation models
Silo, bridge, and pool strategies for isolating tenant data, and the cost/isolation trade-off each one makes.
- multi-tenancy
- data
- trade-offs
PaymentsPayment authorization flow
How an authorization request travels from the client through the gateway and payment service to the acquirer and card network, and how the result returns.
- payments
- sequence
- integration
Architecture notes
All notesOffice hours
Architecture Review Office Hours
A recurring open session to pressure-test one real architecture. Bring a diagram and the decision that's keeping you up at night.
Next session
Office-hours details