Automatiser la vérification de liens en CI/CD

La documentation est du code. Elle mérite donc les mêmes garde-fous : vérification dans les merge requests, surveillance régulière, et règles claires entre liens internes critiques et liens externes plus instables.

Pourquoi automatiser

Éviter les régressions : un déplacement de dossier ou un renommage de page casse vite un README.
Surveiller les dépendances externes : un site partenaire ou une doc fournisseur peut tomber hors ligne sans prévenir.
Rassurer l’équipe : les docs publiées sont testées comme le reste du projet.

Politique recommandée

Échec du pipeline sur les liens internes cassés.
Alerte seulement sur les 403, 429 et certains 5xx temporaires.
Scan ciblé sur les fichiers modifiés dans les MRs.
Audit complet planifié chaque semaine sur la branche par défaut.

Intégration GitHub Actions

Utilisez des outils comme lychee pour bloquer une fusion si un lien interne est cassé.

Surveillance périodique

Programmez un scan hebdomadaire pour détecter quand les sites externes auxquels vous faites référence tombent hors ligne.

Déploiement conseillé

Commencez par README et docs/, puis élargissez le périmètre une fois que les faux positifs sont sous contrôle et que l’équipe accepte les règles.