O Vale é um linter para textos. Ele analisa Markdown, AsciiDoc e reStructuredText, ignora blocos de código e verifica o texto em relação a regras de estilo armazenadas como YAML no repositório, permitindo que as convenções de escrita sejam aplicadas no editor e no CI, de forma semelhante ao estilo de código. Os estilos inclusos abrangem os guias de documentação da Google, Microsoft e Red Hat; outros verificam a linguagem inclusiva ou a legibilidade, e você também pode criar os seus próprios. O Vale faz parte de toolchains de docs-as-code há anos, mas o volume de documentações, ADRs e descrições de PRs rascunhadas por LLMs o torna ainda mais relevante hoje. Pacotes como o vail-ai-tells sinalizam o fraseado típico de textos gerados, e o Vale funciona bem como um dos sensores de feedback para agentes de programação, permitindo que um agente revise um rascunho antes que qualquer pessoa o leia.
As verificações do Vale são correspondências determinísticas de palavras e padrões, capazes de identificar vícios superficiais, mas que podem deixar passar raciocínios fracos ou detalhes inventados. O Vale também depende em grande parte de um único mantenedor, e nosso uso até agora tem sido feito por indivíduos trabalhando em seus próprios textos, e não por equipes de clientes.
