I want a balance between being able to make diagrams pretty and how much work I spend on it. PlantUML has much more thorough example documentation. Even though I bump up against corners in the customization I do want, it’s easier for the role it serves (both documentation but also the source kind of misty gets translated into an acceptable diagram without having to overspecify certain things as I saw in some of the source snippets on that page). This is definitely good if I want to spend a lot making something pretty that I can version control. If that were the case though I’d collaborate with a designer to write that in this tool and make the clarity better (but if they wanted to do a traditional SVG diagram in Illustrator using whatever workflow they want, I wouldn’t care either). If it’s not worth a designer’s time, it’s generally not worth it for me to spend hours on a skill that’s not natural for me. So I like a program that makes it easy to make it pretty enough but that I don’t have to think about too much (eg having it embedded in Wikis at work also helps in the learn 1 useful thing and use it multiple places).