News for hackers. Stuff that matters.
Re:How to draw beautiful software architecture diagrams (2022) by tonnydourado on Friday October 27, 2023 @08:12AM (#38037454)
As an avid plantuml user, I don't think it's that simple. Graph layouts help, but it doesn't take long for automatic layouts to start to get in the way of conveying meaning, and that's even with a higher level description language, like plantuml or mermaid, let alone with raw graphviz. One can quickly start to spend more time trying to make the layout look right than actually evolving it.

Don't have a solution to it, unfortunately. When things in my head start to map too poorly to plantuml, I just consider drawio instead, but it's such a downgrade, that I try to avoid as much as I can.

Re:How to draw beautiful software architecture diagrams (2022) by knsv on Friday October 27, 2023 @09:03AM (#38037882)
Knut, Mermaid's creator here.

I agree that layout auto-adjustments in flowcharts can be problematic, especially when subgraphs represent architectural subsystems as they are not really flowcharts. :)

I'm developing a new Mermaid diagram type for more layout control, with precise block placement.

Re:How to draw beautiful software architecture diagrams (2022) by tonnydourado on Friday October 27, 2023 @09:43AM (#38038334)
Cool! I'm still on the plantuml train, but I like how much easier mermaid is to integrate with (no need for java), so I'm happy to see it evolve!