Documentation soumise à son propre linter
Soumis la documentation à son propre linter — budget de lignes par
fichier ne pouvant que diminuer, obligation d'index et contrôle de
l'existence des chemins — qui a trouvé six plans sur neuf déclarés
terminés avec des cases non cochées et quatorze tâches obligatoires
avant commit absentes des documents.
août 2026

Situation. Le dépôt se gouverne par des instructions écrites —
vingt‑six documents couvrant la politique qualité, le système de
conception, l'accessibilité, l'impression, les métadonnées, la
traduction et git. Les instructions ont un mode de dégradation
précis : elles s'allongent, divergent du code, se mettent à
référencer des fichiers déplacés et, à partir d'une certaine taille,
ne sont plus lues. Une règle non lue n'est pas une règle.

Tâche. La documentation avait besoin du même traitement que le code
— un linter avec des limites qui provoquent un échec plutôt que de
conseiller.

Action. Huit politiques, chacune mécanique. Un plafond strict de
longueur de document et un autre plus souple qui avertit. Un budget
de lignes par fichier qui ne peut que diminuer, de sorte qu'un
document puisse rétrécir sans pouvoir regrossir. Une obligation
d'index au‑delà d'un seuil, et d'index de section au‑delà d'un seuil
plus bas. Une règle de localisation définissant quel document
possède quel sujet. La validité des liens. L'honnêteté des plans —
l'état revendiqué par un plan doit correspondre à ses propres cases.
Une règle imposant que chaque tâche conditionnant un commit soit
nommée dans un document. Et une vérification des chemins réels, pour
que chaque chemin qualifié par un répertoire et chaque symbole de
code nommé par un document existe réellement. La première exécution
a justifié tout l'exercice : six plans marqués terminés avec des
cases non cochées, quatorze tâches conditionnant chaque commit et
nommées dans aucun document, trois liens cassés, un document
orphelin et trois chemins morts dans cinq documents. Le budget a
ensuite refusé son propre auteur — ajouter le résumé de ce travail
au document de développement dépassait sa limite, ce qui a conduit à
créer un document distinct, soit exactement le fonctionnement voulu
de la politique.

Résultat. Vingt‑six documents totalisant environ 2 666 lignes
effectives, chacun sous un budget qui ne peut pas croître, avec
chaque chemin et symbole nommé vérifié contre l'arborescence. Le
constat inconfortable mérite d'être répété : quatorze contrôles
conditionnaient chaque commit sans figurer dans aucun document ; les
règles imposées par la machine et celles lues par les humains
avaient donc déjà divergé.

Catégories:
1Automatisation et CI/CD	/fr/categories/automation/	engineer.company	70
1Tests et assurance qualité	/fr/categories/testing/	engineer.company	70
1Python	/fr/categories/python/	engineer.company	70
1Direction technique	/fr/categories/technical-leadership/	engineer.company	70
1Gestion de projets	/fr/categories/project-management/	engineer.company	70
1Documentation	/fr/categories/documentation/	engineer.company	70

Prestations:
1Direction technique et conseil	/fr/services/technical-leadership/	engineer.company	70
1Gestion de projets agile	/fr/services/project-management/	engineer.company	70
1Documentation technique	/fr/services/technical-documentation/	engineer.company	70

hCette page sur le Web	URL:https://engineer.company/fr/portfolio/put-the-documentation-under-its-own-linter/	engineer.company	70
