RST Validator

Il RST Validator analizza le fonti reStructuredText per rilevare errori di sintassi, nidificazione impropria, riferimenti rotti e uso improprio delle direttive. Si rivolge a sviluppatori, redattori tecnici e team che si affidano ad strumenti Python, Sphinx o a pipeline CI per produrre documentazione pulita e durevole in più repository e lingue.
Concettualmente lo strumento usa un parser basato su docutils per costruire un AST standard, poi applica un insieme configurabile di regole per identificare problemi come ruoli mancanti e sostituzioni poco chiare, fino a riferimenti incrociati non validi. Riporta ogni problema con numeri di riga, severità e indicazioni azionabili.
Il valore unico risiede nel design leggero e orientato all'automazione: può essere eseguito localmente o in CI, produce output leggibile da macchina e fa rispettare convenzioni di progetto tramite regole di lint opzionali. Si concentra sulla struttura invece che sul rendering, rendendolo ideale per pre-commit e revisioni anticipate.
Funzionalità chiave: validazione della sintassi, controlli di riferimenti e direttive, pacchetti di regole configurabili, supporto UTF-8 e uscite adatte all'automazione. Casi d'uso tipici includono validare documenti RST prima del rilascio, durante le build o nelle revisioni del codice per ridurre andate e ritorni.