[abustamam]

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.

[ljm]

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.

[abustamam]

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)