[bluejekyll]

I started using plantuml more rigorously at work. I've found that collaboration on the drawings/diagrams, is simpler and easier as it can be tracked in Git. One additional thing that I've been using as well is the mdBook plugin to embed and render the images as part of a larger book. This has been helpful for large systems when there are many teams involved. We publish the content as github pages on the repos as well.

I'd like to start doing this with my open-source as well.

https://github.com/sytsereitsma/mdbook-plantuml

[politelemon]

We haven't found the same to be true. The moment there's an extra step involved in rendering the image, the advantages have been lost through numerous outdated copies. We found that people relied on the imagery more than the DSL behind it.

We now publish draw.io SVGs. GitHub renders them and people view them. The rendering engine is effectively the browser which makes it very accessible.

I suppose this means our companies have differing cultures or some other factor I'm not aware of

[riffraff]

GitHub supports mermaidjs natively.

I prefer plantuml but mermaid is nice enough.