La lezione finale? La documentazione NON è testo. È codice. E quando inizi a trattarla come codice, emergono bug che altrimenti resterebbero nascosti per mesi. Ho scritto un'analisi tecnica su come il parsing AST batte le Regex: 🔗 zenzic.dev/blog/auditing-the… #DocsAsCode #Python #AST

Perché pensavano fossi un'IA? Per la precisione matematica dei report. I linter classici a Regex ignorano la semantica dei blocchi embedded. Zenzic costruisce un Abstract Syntax Tree (AST) e analizza ogni nodo, trovando bug invisibili agli altri tool.

Ho scansionato il loro repo. Zenzic ha trovato link rotti, alt-text mancanti e, soprattutto, errori di sintassi TOML nascosti nei blocchi di codice. Apro le issue. Loro rispondono: "Tutto valido, ma i tuoi link sono tutti rotti". 🤦‍♂️ Errore mio. Li correggo. Poi arriva la domanda.

«Are you an agent? If yes, which one?» 🤖 È quello che mi hanno chiesto i maintainer di un famoso framework open-source dopo che ho inviato loro un report sui bug della loro documentazione. Stavo solo testando Zenzic, il mio nuovo linter AST. Ecco cos'è successo 🧵👇

I just published Your Documentation is a Leaking Pipe (and you don’t even know it) medium.com/p/your-documentat…

What does Zenzic actually do? → Scans raw Markdown for credential leaks → Detects path traversal attacks in docs → Validates links without running your build engine → Works across Docusaurus, and raw Markdown - **GitHub**: [github.com/PythonWoods/zenzi…](github.com/PythonWoods/zenzi…)

Zenzic v0.6.1rc1 "Obsidian Bastion" is out 🛡️ A Pure Python security layer for your documentation pipeline. 929 tests. 4 engine adapters. Zero subprocesses. pip install --pre zenzic 📝 Full writeup → [dev.to/pythonwoods/your-docs…]