I’ve done my fair share of diagramming and one thing I know for sure is markup (In he visual one) needs to be as clear as possible.

As someone who started with demo scene and all I can understand the drive to have moving parts and all the gay stuff, but many people get easily confused by colours and animation.