5 ms·

I personally have been using mermaid for sequence diagrams and flow charts: https://mermaid.js.org/ https://mermaid.js.org/ DaC seems nicer for infra

adsteel_ 2y ago
Mermaid is fantastic for diagramming architecture. A little quirky, but not too bad. If you're using GitHub it's supported in any markdown file, and therefore accessible to any other dev with repo access. No permissions issues, edits can go through code review, and no dependencies necessary.
- cybrox 2y ago
  Same with GitLab. I really appreciate the builtin Mermaid support.
rpncreator 2y ago
I'm leaning on both Mermaid JS and PlantUML as my daily drivers for diagrams.
nshkrdotcom 2y ago
Mermaid is great, but is quirky. LLM's are well-trained on Mermaid. Gemini specifically is fantastic as a 'diagram assistant'. I was able to create this diagram and a ton of other such diagrams quite easily with Gemini and Mermaid's live editor: https://nshkr.com/SecureSphere-Overview-20241102.png https://nshkr.com/SecureSphere-Overview-20241102.png
- renjimen 2y ago
  I frequently turn notes about infrastructure, pipelines or databases into diagrams with an LLM to ground my team's understanding. The VSCode Mermaid plugin and the GH integration make this very simple to do.
- shepherdjerred 2y ago
  VS Code recently added some AI-related features for Mermaid https://code.visualstudio.com/updates/v1_95#_mermaid-diagram-generation-with-copilot https://code.visualstudio.com/updates/v1_95#_mermaid-diagram...
- 3abiton 2y ago
  I've been using the same, but with Chatgpt. Multiple iterations are needed to get what I want though. Cool trick is that you could import Mermaid using drawio.
- throwaway86530 2y ago
  Sometimes I feel they are even too much trained on Mermaid. I prefer graphviz but claude very often output a mermaid diagram even if I gave a valid graphviz example in my prompt.
shepherdjerred 2y ago
VS Code just released some cool Copilot-related features for Mermaid https://code.visualstudio.com/updates/v1_95#_mermaid-diagram-generation-with-copilot https://code.visualstudio.com/updates/v1_95#_mermaid-diagram...

adsteel_ 2y ago

Mermaid is fantastic for diagramming architecture. A little quirky, but not too bad. If you're using GitHub it's supported in any markdown file, and therefore accessible to any other dev with repo access. No permissions issues, edits can go through code review, and no dependencies necessary.

cybrox 2y ago
Same with GitLab. I really appreciate the builtin Mermaid support.

rpncreator 2y ago

I'm leaning on both Mermaid JS and PlantUML as my daily drivers for diagrams.

nshkrdotcom 2y ago

Mermaid is great, but is quirky. LLM's are well-trained on Mermaid. Gemini specifically is fantastic as a 'diagram assistant'. I was able to create this diagram and a ton of other such diagrams quite easily with Gemini and Mermaid's live editor: https://nshkr.com/SecureSphere-Overview-20241102.png https://nshkr.com/SecureSphere-Overview-20241102.png

renjimen 2y ago
I frequently turn notes about infrastructure, pipelines or databases into diagrams with an LLM to ground my team's understanding. The VSCode Mermaid plugin and the GH integration make this very simple to do.
shepherdjerred 2y ago
VS Code recently added some AI-related features for Mermaid https://code.visualstudio.com/updates/v1_95#_mermaid-diagram-generation-with-copilot https://code.visualstudio.com/updates/v1_95#_mermaid-diagram...
3abiton 2y ago
I've been using the same, but with Chatgpt. Multiple iterations are needed to get what I want though. Cool trick is that you could import Mermaid using drawio.
throwaway86530 2y ago
Sometimes I feel they are even too much trained on Mermaid. I prefer graphviz but claude very often output a mermaid diagram even if I gave a valid graphviz example in my prompt.

shepherdjerred 2y ago

VS Code just released some cool Copilot-related features for Mermaid https://code.visualstudio.com/updates/v1_95#_mermaid-diagram-generation-with-copilot https://code.visualstudio.com/updates/v1_95#_mermaid-diagram...