What does HackerNews think of mermaid?
Generation of diagrams like flowcharts or sequence diagrams from text in a similar manner as markdown
They're easier to read than plain text explanations for architectural layouts/customer journeys but easier to modify than images and GIFs.
Also natively supported in many flavours of markdown like Gitlab.
[1] https://github.com/mermaid-js/mermaid [2] https://code.sgo.to/typograms/#related
I've been pondering building a big interactive chart, like a decision tree or differential diagnosis chart, that maps goals/needs/problems to docs/examples/tools (for the Nix/NixOS/Nixpkgs ecosystem, but the basic concept applies to any sprawling ecosystem where discovery is hard).
I recently stumbled on https://github.com/mermaid-js/mermaid, which seems like it has an interaction model that could support what I have in mind (minus the question of whether there are performance cliffs that'd make it unsuitable).
If you considered mermaid while working on bear-note-graph, could you share the conclusions you came to?