Category

Visual Studio Code

Awesome, Text-Based Diagrams with Mermaid

By | Visual Studio Code | No Comments

A picture is worth a thousand words.¬†Plain text can convey high levels of detail, but when there are multiple entities involved, text fails to communicate the relationships between them well. In a recent incident, I needed to explain to myself and others how information flowed between four different actors in a transaction. Oral and written attempts would quickly become confusing because of the difficulty of keeping the state of all the different actors in our heads at once. In comparison, once the transaction was laid out in a diagram, the flow of information immediately become far easier to understand for…

Read More