Re:Swimlanes.io – generated editable sequence diagrams
by mjallday on Wednesday April 28, 2021 @03:24PM
(#26973070)
Logged in specifically to agree and upvote this comment!
- on-demand preview of changes before i hit save
- source code is always embedded with the diagram and anyone can reference and edit
- source controlled history via confluence history
I've used mermaid extensively but ultimately abandoned it because it didn't have a good flow for sharing the source and history. Confluence + PlantUML is a great solution.
Re:Swimlanes.io – generated editable sequence diagrams
by andreareina on Tuesday April 27, 2021 @10:21PM
(#26964718)
Big fan of PlantUML, didn't occur to me that there'd be Confluence plugins. Which one are you using?
Re:Swimlanes.io – generated editable sequence diagrams
by gregmac on Wednesday April 28, 2021 @01:59AM
(#26966146)
I didn't realize there were multiple now! We use "PlantUML for Confluence" [1] now but have had that for a few years. The live preview thing some of the others seem to have would be nice.
[1] https://marketplace.atlassian.com/apps/41025/plantuml-for-co...
The source shows up in edit mode (no external app needed; and it's always correct) and it handles the rendering for you, thus reducing friction.
In other places I've seen people attach a PNG. If you're lucky, they've also attached the corresponding (and up-to-date) source in visio/draw/ppt/whatever random app format, in which case making a small edit might only takes ten of minutes. In the worst case, it's missing source, the source file is not the same as the PNG, or they used some program you don't have, and you have to totally redo it. For most people if the friction is too high, it just doesn't get updated.