News for hackers. Stuff that matters.

A comment on Design structured diagrams, built to increase your team's trust in your docs.

Re:Design structured diagrams, built to increase your team's... by css on Saturday May 15, 2021 @10:39AM (#27165612)
A question I always have for diagramming software is how it handles refactoring. This is often the most frustrating part of every tool. How does IcePanel improve this experience? Group selection and dragging to hopefully have enough room for something new is not workable in complex diagrams.
[ Parent | on HN ]
Re:Design structured diagrams, built to increase your team's... by Veuxdo on Saturday May 15, 2021 @10:44AM (#27165639)
For diagrams that are long-lived and refactorable, diagrams-as-code is really your only option. Changing complex diagrams with drag-and-drop interfaces is a nightmare.
[ Parent | on HN ]
Re:Design structured diagrams, built to increase your team's... by ta988 on Saturday May 15, 2021 @10:45AM (#27165647)
I wish there would be a mixture of diagrams.net and mermaid.
[ Parent | on HN ]
Re:Design structured diagrams, built to increase your team's... by kitd on Saturday May 15, 2021 @01:05PM (#27166939)
draw.io/diagrams.net has a mermaid plugin

https://github.com/nopeslide/drawio_mermaid_plugin

[ Parent | on HN ]
Re:Design structured diagrams, built to increase your team's... by ta988 on Sunday May 16, 2021 @10:51AM (#27174101)
Fantastic, thanks.
[ Parent | on HN ]
Re:Design structured diagrams, built to increase your team's... by Veuxdo on Saturday May 15, 2021 @11:12AM (#27165920)
What would that ideal mixture look like to you?
[ Parent | on HN ]
Re:Design structured diagrams, built to increase your team's... by ta988 on Saturday May 15, 2021 @12:48PM (#27166795)
drawio using the templating engine of mermaid. So it would have a "restricted mode" that matches roughly to what mermaid would output.
[ Parent | on HN ]
Re:Design structured diagrams, built to increase your team's... by JacobDesigns on Saturday May 15, 2021 @11:00AM (#27165775)
We want to help users spread complexity across several diagrams with the aim of reducing enormous diagrams that cause confusion. IcePanel allows you to quickly create tabs for each diagram you want to communicate and a model view to keep all the properties in sync.

We're also looking at how we can bring our diagrams into source control to allow it to be maintained easier.

[ Parent | on HN ]
Re:Design structured diagrams, built to increase your team's... by edsonmedina on Saturday May 15, 2021 @11:16AM (#27165964)
If a diagram is too complex, shouldn't you just add more abstractions? That would simplify the refactoring too.
[ Parent | on HN ]