4 ms·
Plantuml plugin within Confluence is pretty nice for documentation, and arguably a super-power because it makes it easier to make good docs ("a picture is worth
by gregmac 5y ago
Plantuml plugin within Confluence is pretty nice for documentation, and arguably a super-power because it makes it easier to make good docs ("a picture is worth a thousand words").
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.
- andreareina 5y agoBig fan of PlantUML, didn't occur to me that there'd be Confluence plugins. Which one are you using?
- gregmac 5y agoI 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-confluence https://marketplace.atlassian.com/apps/41025/plantuml-for-co...
- mjallday 5y agoLogged 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.