Show HN: Create diagrams of complex data flows in software systems

Re:Show HN: Create diagrams of complex data flows in softwar... by beardedwizard on Tuesday July 30, 2024 @10:13AM (#41109399)

I think this captures the sentiment I have been seeing and feeling myself. Docs and diagrams die because they aren't code. When the code changes, the docs are left behind.

What is interesting here is that mermaid and graphviz could be committed to source control, but I have never seen it done anywhere likely because the burden of drawing/updating is still too high (hence your wysiwyg comment).

[ Parent | on HN ]

Re:Show HN: Create diagrams of complex data flows in softwar... by iamthefury on Wednesday July 31, 2024 @03:16PM (#41122445)

I helped implement Mermaid as a part of Apollo GraphQL’s public documentation to address the “docs as versioned artifact with code” challenge. It’s a win, but still another Yak to shave since public docs are a product, not the source code for the internal teams’ use.

[ Parent | on HN ]