As you would expect, it has its pros and its cons. As diagrams get bigger and more complex, mermaid's auto-layout gets more and more challenged and more and more acres of white space start to appear. Of course drawing those same large diagrams manually would be a bitch too.
At small scale, auto-layout is a no-brainer, but the jury is still out for us on large, real world diagrams.
The guy that makes it is super helpful on twitter as well.
Ah, I've just realised, the article above pointed to a quote by Simon Brown - he is the Structurizr guy :-)
Ideally, I want diagrams-as-code with a supporting layout-as-code document for fine-tuning the presentation and a wysiwyg tool for manipulating that layout-as-code document.
But I understand why none of this exists: the MVP is too big.
I've generally always found it difficult to find something in this space that produces a layout that's easy to follow, and easy to experiment with.
I think I'd like something that had: - layout constraints similar to the android relative layout - something like excalidraw that could dump the hand drawn diagram out to code for a bit of cleanup before going into VCS
I'm imagining you could solve the ability to inject new sections with the constraints relatively easily but still retain a good amount of creative control to better tell the story.
Any suggestions for tools to checkout?