News for hackers. Stuff that matters.
Re:Mermaid: Diagramming and Charting Tool by klabetron on Friday August 16, 2024 @04:01AM (#41264204)
I love mermaid because it’s so easily source-controlled. It also has pretty solid documentation.

Don’t love that each diagram type typically has significantly different syntax.

Also don’t love (as mentioned by another commenter) the lack of control over layout—yea there are some advanced options for this but I find them obscure and difficult to configure.

I did create an internal tool that scans my Firestore data model and outputs an ER Diagram in mermaid. Works really nicely for that.

Re:Mermaid: Diagramming and Charting Tool by mycall on Friday August 16, 2024 @09:10AM (#41266109)
I'm surprised nobody has fixed the layout yet. I often get graph nodes that draw off screen as it easily get too wide too fast.
Re:Mermaid: Diagramming and Charting Tool by charles_f on Friday August 16, 2024 @11:08AM (#41267090)
You summarized well my three complaints about the tool.
Re:Mermaid: Diagramming and Charting Tool by ajax7 on Friday August 16, 2024 @12:16PM (#41267715)
Is your tool open source by chance?
Re:Mermaid: Diagramming and Charting Tool by kelseyfrog on Saturday August 17, 2024 @12:08PM (#41275514)
There's basic layout issues that can drive users mad.

I wanted to left justify text[1] in a note for a sequence diagram. It only worked in their live editor vs their cloud-backed web app because only the former exposes styling.

1. it's otherwise locked to center justified

Re:Mermaid: Diagramming and Charting Tool by THBC on Sunday August 18, 2024 @01:40AM (#41280350)
Just make some of your relationship arrows longer by adding more dashes.