These tools are neat and handy for simple diagrams. Love mermaid. For more complex diagrams, where explainer notes are beneficial, I find hand tweaked diagrams

These tools are neat and handy for simple diagrams. Love mermaid. For more complex diagrams, where explainer notes are beneficial, I find hand tweaked diagrams can not be beaten (my go to is draw.io) If a simple DaC diagram is 1000 words, then a hand tweaked diagram is 10,000. And that 10,000 pays off. The bang for buck payoff is there. Of course, other considerations like maintainability etc etc