On: Design structured diagrams, built to increase your...

[drewpc]

> I’ll never use a proprietary tool that doesn’t have declarative syntax

Can you provide an example of what you're referring to?

[petepete → drewpc]

PlantUML diagrams are generated from plain text, they can easily be embedded in markdown or even in code (I'm sure there's a plug-in for that!)

Plenty of examples here.

https://plantuml.com/state-diagram

[gregmac → petepete]

And importantly, because they're text, they can live in a version-controlled environment. I mainly use them within Confluence, and even there you can diff between versions to see changes.