Live data from Hacker News

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

github.com

61–67 of 67 posts

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

#62
post #55

https://gg-charts.com/#=&file=eJyVksFSgzAQhu88xQ4X9FBa2jodkT...

For those reading this, do not click on that link above. It executes a script that renders the app unusable until you clear your local storage. Thanks for the report, I'll fix that.

Fixed in production!

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

#64

Earlier quoted context omitted.

Org files with embedded PlantUML blocks get close to what you want.

Who is using this? I have only seen plantuml written about on blogs, never actually in use.

I’ve used it for a long time; even if I don’t end up sharing with others it can help me quickly visualize things (the ease of change often makes better than pen and paper). At one of my jobs we had an architect join and he was amazing; I really respected him. He used PlantUML and would open it up and start writing sequence diagrams with us. He would make sure complex flows that were actively being implemented were kept up to date and they were useful references.

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

#65

Earlier quoted context omitted.

My take is that it's a bit worse than that: the whole doc tooling scene is a dumpster fire. I want to maintain technical documentation under revision control (same revision control system as I use for source code), and I want to be able to embed diagrams in said documents (also under revision control) and I want to wysiwyg edit those things. Amazingly in 2024 this does not exist.

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).

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.

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

#67
post #43
post #10

Thanks for this! I love how minimal and intuitive it is. Feature request - ability to export to Animated PNG!

I'll create an issue to support exporting the animation in v1. Any particular reason for APNG vs GIF? The animation in the README.md was captured with the MediaRecorder API. It produced a webm that I "cropped -> clipped -> to gif" manually. I am not that far to produce a looping webm that is perfectly cropped & clipped. I may release that first, and then tackle gif / apng / ??? later.

> Any particular reason for APNG vs GIF?

GIFs support only 256 colors while APNG supports millions of colors and does have multi-browser support now. PNGs are also inherently high quality and don't pixelate like lossy image formats - GIF, JPG etc.

Post reply on HN