RST Validator

O RST Validator analisa fontes de reStructuredText para detectar erros de sintaxe, aninhamento incorreto, referências quebradas e uso indevido de directives. Ele atende desenvolvedores, redatores técnicos e equipes que dependem de ferramentas Python, Sphinx ou pipelines CI para produzir documentação limpa e durável em vários repositórios e idiomas.
Conceitualmente a ferramenta utiliza um parser baseado em docutils para construir um AST padrão, depois aplica um conjunto configurável de regras para identificar problemas desde papéis ausentes e substituições obscuras até referências cruzadas inválidas. Ele reporta cada problema com números de linha, severidade e orientações acionáveis.
Seu valor único reside no design leve e orientado para automação: pode ser executado localmente ou em CI, produzir resultados legíveis por máquina e impor convenções de projeto por meio de regras de lint opcionais. Foca na estrutura ao invés de renderização, tornando-o ideal para checks de pré-commit e revisões iniciais.
Funcionalidades centrais incluem validação de sintaxe, checagens de referência e diretiva, pacotes de regras configuráveis, suporte UTF-8 e saídas adequadas para automação. Casos de uso típicos incluem validar documentos RST antes de lançamentos, durante builds ou em revisões de código para reduzir idas e vindas.