Solutions Architect Tips — The 5 Types of Architecture Diagrams
Solutions Architect Tips — The 5 Types of Architecture Diagrams

Photo by Kelly Sikkema on Unsplash.

Have you ever been in a meeting where someone is trying to explain how a software system works?

I was having a conversation with a relatively new solutions architect who was trying to describe a system they had come up with. It had about eight different components to it and they all interacted with each other in multiple ways.

They were explaining the solution using hand gestures and a lot of “and this piece communicates with this one by…”

I understood the words coming out of their mouth, but they didn’t make sense strung together.

Words get lost when explaining complex conceptual architecture. I was trying to build a mental model while following a train of thought. I needed a visual.

I needed a diagram.

But not just any diagram. Architecture diagrams are not a “one size fits all” solution.

We’ve discussed recently that a significant part of being a solutions architect is effectively communicating your ideas to both technical and non-technical audiences.

Your diagrams must take that into consideration. If you want to get your idea across to different sets of people, you must make multiple versions of your diagrams.

Today, we are going to talk about the five different types of diagrams you should make depending on five different audiences.

We will take an example from my fake business but real API, Gopher Holes Unlimited, where we add a new gopher into the system to be tracked.
['Allen Helton']
['Software Engineering', 'Programming', 'Software Development', 'Careers', 'Technology']