There's another HN discussion going, about declarative diagramming [0], from where I learned about Ilograph [1]. And which makes great use of animations for system documentation.

[0] https://news.ycombinator.com/item?id=45706792

[1] https://www.ilograph.com/features.html

I think diagrams are opinionated. I’d like to show animations instead of just colors. Data flow for example. Yes arrows help, but animations help better. It is all about personal preference. There is no right or wrong.

What if that style is already used though? (e.g. other connections are red)