Articles avec le tag: CI/CD
Traitez la documentation comme un artefact de build : validez structure, liens, exemples et règles avant publication. La CI ne peut pas juger l’utilité d’une explication, mais elle peut bloquer des défauts prévisibles avant de consommer du temps humain.
Si un modèle crée ou modifie du contenu à grande échelle, la validation doit suivre. Limitez les entrées, conservez la provenance, validez la structure et séparez génération et publication privilégiée. Une bonne architecture suppose que le modèle se trompera parfois.
Le linting éditorial est utile lorsqu’il détecte la dérive terminologique, les formulations risquées et les défauts répétitifs. Gardez peu de règles, explicables et assez silencieuses pour qu’un échec soit pris au sérieux. Un linter peut contrôler des milliers de phrases en quelques secondes, ce qui donne envie d'encoder chaque préférence éditoriale.