Transforming Ripgrep's Documentation with AI Automation and MkDocs

The author describes a third-generation documentation automation workflow that expanded ripgrep's two documentation files into 55 pages, using automatic page splitting, per-page visual enhancement, and Mermaid diagram validation via a new tool called mermaid-sonar. The workflow runs on MkDocs Material and adds 87 Mermaid diagrams, 358 admonitions, and 180+ code annotations, with a strict build passing. The post also compares the workflow to earlier mdBook-based versions and outlines steps for adapting it to other projects.