RST Validator

RST Validator analiza las fuentes de reStructuredText para detectar errores de sintaxis, anidamiento incorrecto, referencias rotas y uso indebido de directivas. Está dirigido a desarrolladores, redactores técnicos y equipos que dependen de herramientas Python, Sphinx o pipelines CI para producir documentación limpia y duradera en varios repositorios e idiomas.
Conceptualmente la herramienta utiliza un analizador basado en docutils para construir un AST estándar, luego aplica un conjunto de reglas configurables para identificar problemas desde roles faltantes hasta sustituciones opacas y referencias cruzadas inválidas. Informa cada problema con números de línea, severidad y orientación accionable.
Su valor único reside en un diseño ligero y orientado a la automatización: puede ejecutarse localmente o en CI, produce resultados legibles por máquina y aplica convenciones del proyecto mediante reglas de lint opcionales. Se centra en la estructura en lugar de renderizado, lo que la hace ideal para comprobaciones previas al commit y revisiones tempranas.
Funciones clave: validación de sintaxis, comprobaciones de referencias y directivas, paquetes de reglas configurables, soporte UTF-8 y salidas aptas para automatización. Casos de uso típicos: validar documentos RST antes de lanzamientos, durante compilaciones o en revisiones de código para reducir idas y vueltas.