A few things we've written
Ideas and trends from system architecture, design, and documentation.
More Articles
C4 Model vs UML: Which Should Your Team Actually Use?
UML has 14 diagram types. Most teams use two or three. The C4 model offers a pragmatic alternative: four levels of abstraction that developers actually want to maintain.
Modeling vs Diagramming: Why the Best Teams Do Both
Pure modeling fails because nobody uses it. Pure diagramming fails because it turns into chaos. The teams that get architecture documentation right find the balance — diagram-first, model-backed.
The Software Architecture Documentation Tool Your Team Will Actually Use
Most architecture documentation dies within weeks. The problem isn't discipline. It's tools built for a world that doesn't exist anymore. Here's what modern teams actually need.
C4 Model Use Cases: The Missing Layer Your Diagrams Need
Your C4 diagrams show what exists. But they don't show how it's used. Here's how to layer use cases on top of your architecture to answer the questions that actually matter.
How to Document Azure Solutions — The Efficient Way
Azure environments grow fast — and traditional documentation can't keep up. Learn how to document your Azure solutions efficiently with diagrams that stay accurate, automated, and always in sync with your real environment.
C4 Model Diagrams: Practical Tips for Every Level (With Examples)
Practical C4 model tips from real teams. How to create Context, Container, and Component diagrams that people actually maintain — with examples for each level and common mistakes to avoid.
Enterprise Architecture Tools Are Overkill — Here's a Lightweight Alternative
Tired of bloated enterprise architecture tools? Discover why modern teams are switching to lightweight, C4-based modeling tools like Revision to stay agile, collaborative, and clear.
Why Dependencies Are the Hardest Part of Documenting Large Architectures
The bigger your system gets, the harder it is to know what connects to what. Here's why dependencies stay invisible until something breaks — and how to make them explicit before that happens.
Fundamentals of System Integration
A vendor-agnostic article that explains the fundamentals of system integration, commonly used building blocks and patterns.
Top Icon Resources for Diagrams: Azure, AWS, Google Cloud, and More
Need icons for your cloud architecture or software diagrams? These resources offer the latest Azure, AWS, and Google Cloud icons, and more—saving you time and ensuring your visuals are always up-to-date.
Azure DevOps Diagrams: 3 Ways to Keep Architecture Docs Alive
How to add software architecture diagrams to Azure DevOps — from Mermaid in your wiki to always up-to-date embeds. Compare three approaches with pros, cons, and real examples.
From Good to Great: Small Details That Improve Your C4 Model Diagrams
Enhance your C4 model diagrams with simple tips to improve clarity and effectiveness. Learn how to create, document, and share software architecture diagrams efficiently using best practices.