Comment by abustamam
12 days ago
For better or for worse my team has standardized on using Miro for technical designs and diagrams. It's a lot easier to visualize the system in a diagram than it is to talk about it in prose.
I think it's important to choose the right medium for communication though. Some things just need to be written out concisely.
Mermaid has been great for a similar reason. For example, you can render a mermaid diagram inside a PR description on GitHub.
Comes in handy when describing a state machine or the flow of data.
Yeah! I recently discovered those, mainly because Claude seems to love mermaid diagrams, and Cursor has a renderer for it (it's not great but it's pretty easy to port to Miro)