When you look at the cover of a box of LEGOs you don’t see a picture
of each individual brick that’s inside. Instead, you see the picture of
an exciting, fully assembled model, such as a pirate ship. To make it
even more exciting, the model isn’t sitting on a living room table but
is positioned in a life-like pirate’s bay with cliffs and sharks—Captain Jack Sparrow would be jealous.
What does this have to do with communicating system architecture and
design? Sadly, not much, but it should! Technical communication too
frequently does the opposite: it lists all the individual elements in
painstaking detail but forgets to show the pirate ship. The results are
tons of boxes (and hopefully some lines; see Chapter 23),
without a clear gestalt or overall value proposition.
Is this a fair comparison, though? LEGO is selling toys to kids, whereas
architects need to explain the complex interplay between components to
management and other professionals. Furthermore, IT professionals have
to explain issues like network outages due to flooded network segments,
something much less fun than playing pirates. I’d posit that the analogy
holds and we can learn quite a few things from the pirate ship for the
presentation of IT architecture.
Grab Attention
The initial purpose of the ...
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.
