Part of my job as chief architect is to review and approve system
architectures. When I ask teams to show me “their architecture,” I
frequently don’t consider what I receive to be an architecture document. Their counter-question of “what do you expect?” isn’t so easy for me to answer: despite many formal definitions, it isn’t immediately clear what architecture is or whether a document really depicts an architecture. Too often we have to fall back to the “I know it when I see it” test
famously applied by a US Supreme Court judge to
obscene material.1 We’d hope that identifying architecture is a more noble
task than identifying obscene material, so let’s try a little harder. I
am not a big believer in all-encompassing definitions but prefer to use
lists of defining characteristics or tests that can be applied. One of
my favorite tests for architecture documentation is whether it contains
any nontrivial decisions and the rationale behind them.
Defining Software Architecture
So many attempts at defining software architecture have been made that
the Software Engineering Institute (SEI) maintains a
reference page of these definitions.
Among the most widely used is this definition from Garlan and Perry,
from 1995:
The structure of the components of a system, their interrelationships, and principles ...
Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month, and much more.
O’Reilly covers everything we've got, with content to help us build a world-class technology community, upgrade the capabilities and competencies of our teams, and improve overall team performance as well as their engagement.
Julian F.
Head of Cybersecurity
I wanted to learn C and C++, but it didn't click for me until I picked up an O'Reilly book. When I went on the O’Reilly platform, I was astonished to find all the books there, plus live events and sandboxes so you could play around with the technology.
Addison B.
Field Engineer
I’ve been on the O’Reilly platform for more than eight years. I use a couple of learning platforms, but I'm on O'Reilly more than anybody else. When you're there, you start learning. I'm never disappointed.
Amir M.
Data Platform Tech Lead
I'm always learning. So when I got on to O'Reilly, I was like a kid in a candy store. There are playlists. There are answers. There's on-demand training. It's worth its weight in gold, in terms of what it allows me to do.
O’Reilly covers everything we've got, with content to help us build a world-class technology community, upgrade the capabilities and competencies of our teams, and improve overall team performance as well as their engagement.
