Skip to main content

2 posts tagged with "API versioning"

View All Tags

· 4 min read
Xiaowen Zhang


When it comes to designing and managing APIs, effective communication and collaboration are essential. One powerful tool that can help bridge the gap between developers, product managers, and stakeholders is the sequence diagram. Sequence diagrams provide a visual representation of the interactions between different components or entities within a system, making it easier to understand the flow of data and the order of events.

In this blog post, we will explore the benefits of using sequence diagrams to model and manage APIs, and provide practical examples to help you get started.

· 6 min read
Xiaowen Zhang

Original Article by Kevin Hakanson

Architecture diagrams visually communicate and document the high-level design of a solution. As the level of detail increases, so does the diagram’s size, density, and layout complexity. Using Sequence Diagrams, you can explore additional usage scenarios and enrich your understanding of the distributed architecture while continuing to communicate visually.

This post takes a sample architecture and iteratively builds out a set of Sequence Diagrams. Each diagram adds to the vocabulary and graphical notation of Sequence Diagrams, then shows how the diagram deepened understanding of the architecture. All diagrams in this post were rendered from a text-based domain specific language using a diagrams-as-code tool instead of being drawn with graphical diagramming software.