Artigos com a tag: CI/CD
Trate documentação como artefato de build: valide estrutura, links, exemplos e regras antes da publicação. CI não decide se uma explicação é útil, mas rejeita defeitos previsíveis antes de gastar atenção humana.
Se um modelo cria e atualiza conteúdo em escala, a validação precisa crescer junto. Restrinja entradas, preserve provenance, valide estrutura e separe geração da etapa privilegiada de publicação. Uma boa arquitetura assume que o modelo às vezes erra.
Style linting é valioso quando detecta deriva terminológica, linguagem de risco e defeitos editoriais repetíveis. Mantenha poucas regras, explicáveis e silenciosas o bastante para que uma falha tenha credibilidade. Um linter consegue revisar milhares de frases em segundos, então é tentador codificar toda preferência editorial.