Auditing the Auditors: Finding Documentation Defects with AST-Based Analysis
· 5 min read
To validate the parser and snippet-analysis capabilities of Zenzic, we needed a production-grade documentation corpus. We selected the official documentation repository of Zensical, a mature and actively maintained static site generator.
The expectation was straightforward: a well-maintained documentation codebase should produce few, if any, actionable findings.
Instead, the scan surfaced a small set of defects that had survived normal review processes. None were catastrophic, but all had user-facing consequences ranging from copy-paste failures to broken navigation and accessibility regressions.
This article examines the findings and explores why documentation quality often requires deeper analysis than conventional Markdown validation.