Creating Visual Notes for Amazon Web Services — My Step-by-Step Process

Jerry Hargrove
Feb 24, 2019 · 4 min read
Image for post
Image for post

Readers often ask me how I create the diagrams found at What’s the process I follow when I author my visual notes? What tools do I use to create them?

In this post, I’ll answer those questions and walk you through the steps I take when I create a new diagram for a service. You’ll see that evolving a diagram from an idea to an image is simpler than you might think.

Let’s get started.

Step #1: Choose a Service

First, I choose an AWS service as a topic. Luckily, the pace of innovation at AWS usually means the pool of available topics is large. Choosing the service is usually the easiest part of the process.

When choosing a service, I try to find one that I’m interested in learning about or a service that might be useful for a customer I’m working with. For example, last year I was interested in learning more about machine learning on AWS, so I created diagrams for several services including Amazon Machine Learning, Amazon Rekognition, Amazon SageMaker, and Amazon Comprehend.

Step #2: Research the Service

Once I’ve made the selection and have decided which service I’m going to draw about, I begin researching the service and gathering details about it. This process is similar to what I might do if I was going to write a blog post or article about the service:

One thing to keep in mind is that these diagrams are supposed to provide an overview of a service. I expect that readers who want additional detail will continue on to the services’ product pages (which I link to in every diagram).

More about this in the next step.

Step #3: Decide on Detail

Armed with a decent overview of a service, its features, and its use cases, it’s time to decide on what information and what level of detail to include in the diagram. Too much detail and the diagram can be difficult to digest quickly and a burden for me to maintain.

I think I’ve struck the right balance with some of my most recent diagrams, both in style and detail. The Amazon DocumentDB diagram is an excellent example of what I consider the right level of detail for my diagrams.

Some AWS services are too vast to cover in a single diagram, like AWS Elastic Cloud Compute (EC2). Instead, I’ve chosen to break them down into more manageable sub-topics, like EC2 Spot Instances and the Evolution of the EC2 Host.

In the process of deciding what to include, I often create a high-level outline, use a mind-map (like for the AWS Well Architected Framework), or create a rough draft (sketch). These tools help focus my thoughts and narrow down the topic, similar to what I might do when writing a blog (like this one).

Step #4: Draw the Diagram

Once I’ve decided on what information I’m going to include and have an idea for how I want to visualize this information, I get to put pencil to paper (figuratively, of course). All of the diagrams you see on my website are created with the same set of tools:

After several years of experimenting with different tablet/stylus/app combinations, I settled on the tools listed above.

Step #5: Publish to the Web

Satisfied with the details and layout of the diagram, I upload the diagram to my website. That process and how the diagram is converted to different formats and integrated into my website, as well as details on the website itself, are described in more detail here.

I publish each new diagram via Twitter, LinkledIn, Reddit, and HackerNews. Depending on the medium, I’ll post each diagram one or more times to ensure complete coverage.


That’s it. From start to finish, I typically spend between 2 to 8 hours researching, preparing and creating each diagram. Some services take longer, particularly those I’m not familiar with and haven’t used before.

I use the same process and tools for AWS services and features and for breakout sessions at AWS re:Invent, although for breakout sessions, I usually only use the session video as my information source.

Creating these diagrams has been a great learning tool for me. My learning style tends to be more visual than anything else, and these diagrams help reinforce key leanings and ideas for me.

If you’re a visual learner, I hope these diagrams have been helpful to you, too.


How do you familiarize yourself with new AWS services and features?

Welcome to a place where words matter. On Medium, smart voices and original ideas take center stage - with no ads in sight. Watch

Follow all the topics you care about, and we’ll deliver the best stories for you to your homepage and inbox. Explore

Get unlimited access to the best stories on Medium — and support writers while you’re at it. Just $5/month. Upgrade

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store