# 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é.

---

- Rôle: Cheffe de produit technique
- Catégories: [Automatisation et CI/CD](https://engineer.company/fr/categories/automation/), [Tests et assurance qualité](https://engineer.company/fr/categories/testing/), [Python](https://engineer.company/fr/categories/python/), [Direction technique](https://engineer.company/fr/categories/technical-leadership/), [Gestion de projets](https://engineer.company/fr/categories/project-management/), [Documentation](https://engineer.company/fr/categories/documentation/)
- Prestations: [Direction technique et conseil](https://engineer.company/fr/services/technical-leadership/), [Gestion de projets agile](https://engineer.company/fr/services/project-management/), [Documentation technique](https://engineer.company/fr/services/technical-documentation/)

<https://engineer.company/fr/portfolio/put-the-documentation-under-its-own-linter/>
