The 'graveyard' of architecture diagrams that were accurate for two weeks is painfully familiar, and the reason given is right: the diagram cannot read the compose file or manifests that are the real source of truth. Rendering EXPLAIN (FORMAT JSON) plans as a heat-mapped tree is a clever extra, since query plans are hard to read as raw JSON. Round-tripping with Mermaid and D2 also means the diagram can live in the repo next to the code it describes.
StackShortlist
The 'graveyard' of architecture diagrams that were accurate for two weeks is painfully familiar, and the reason given is right: the diagram cannot read the compose file or manifests that are the real source of truth. Rendering EXPLAIN (FORMAT JSON) plans as a heat-mapped tree is a clever extra, since query plans are hard to read as raw JSON. Round-tripping with Mermaid and D2 also means the diagram can live in the repo next to the code it describes.