Build-time PlantUML rendering — plus the docgen-bases
crate reserved on crates.io ahead of 0.6.0, taking the
workspace to thirteen crates.
PlantUML has no browser renderer, so unlike mermaid it cannot be deferred to the reader. docgen renders each diagram against a PlantUML server while building and inlines the resulting SVG, leaving the published site fully static with no runtime dependency on that server.
Two decisions make it practical. Every diagram is cached on disk, keyed by a
hash of its source and the server URL — so incremental dev rebuilds stay fast, and
a full rebuild still succeeds for cached diagrams even when the server is
unreachable. And a diagram never breaks the build: an unreachable server, a
syntax error, or a missing src file each render a detailed, visible error block
naming the actual failure, and the build goes on.