Mermaid-Sonar: Detecting Hidden Complexity in Diagram Documentation

The Problem with AI-Generated Diagrams # When building the MkDocs automation workflow for ripgrep, I ran into a consistent problem: diagrams could be syntactically incorrect or cognitively overwhelming and actually hurt comprehension rather than helping it. There could also be semantic and business logic issues with the diagrams, but we&rsquo;ll set that issue aside for this post.