Module 08 · Cours 0803

Produire la documentation
IaC avec l'IA

Transformer une tâche fastidieuse en processus intégré au workflow de développement

Pratique · 45 min
@Victorlanglois
1 / 13
Objectifs d'apprentissage

À la fin de ce cours,
vous saurez :

1
Mettre en place un pipeline Doc-as-Code
2
Utiliser terraform-docs et ansible-galaxy pour générer des README
3
Identifier ce que l'IA ne sait pas faire (le "pourquoi" métier)
@Victorlanglois
2 / 13
Le problème

La documentation obsolète
coûte cher

Erreurs de déploiement
MTTR augmenté
Onboarding ralenti
"Connaissance tribale"
Impact non évaluable
Architecture fragmentée
@Victorlanglois
3 / 13
La solution

Le pipeline Doc-as-Code

Traiter la documentation comme du code : versionnée, revue, déployée automatiquement.

1
Commit Git déclenche
→
2
Génération auto (IA/outil)
→
3
PR créée pour revue
→
4
Merge après validation

Code ET documentation dans le même commit

@Victorlanglois
4 / 13
Outils

Équivalences Terraform / Ansible

Action Terraform Ansible
Générer structure terraform-docs markdown . ansible-galaxy init
Consulter doc native terraform providers ansible-doc <module>
Lister variables Lecture variables.tf grep defaults/main.yml
Valider doc Pre-commit hook ansible-lint
@Victorlanglois
5 / 13
Exemple Terraform

Documenter un module SQS

Commande
terraform-docs markdown . > README.md
Prompt IA complémentaire
À partir du code Terraform fourni, générez :
1. Une description du module (le "pourquoi")
2. Un diagramme Mermaid de l'architecture

terraform-docs génère inputs/outputs → l'IA ajoute le contexte narratif

@Victorlanglois
6 / 13
Utilisez-vous déjà
terraform-docs ou ansible-galaxy ?

Pre-commit hook · CI/CD · Manuel

@Victorlanglois
7 / 13
Exemple Ansible

Documenter un rôle Nginx

Commandes
# Créer la structure avec README template
ansible-galaxy init roles/nginx --force

# Consulter la doc d'un module
ansible-doc ansible.builtin.apt
Prompt IA complémentaire
Générez un exemple de playbook utilisant ce rôle
+ un diagramme Mermaid du flux d'exécution
@Victorlanglois
8 / 13
Esprit critique

Ce que l'IA ne sait pas faire

L'IA fait bien
Lister inputs/outputs
Générer structure README
Créer diagrammes Mermaid
Formater la syntaxe
L'IA ne sait pas
Expliquer le "pourquoi" métier
Documenter les compromis
Garantir l'exactitude
Connaître l'historique

Vous ajoutez le contexte métier, l'IA structure

@Victorlanglois
9 / 13
Règles d'or

Toujours valider
via PR

Jamais de merge auto de doc IA
Revue humaine systématique
Scanner les secrets avant merge
Mesurer la qualité dans le temps
@Victorlanglois
10 / 13
Insight DORA

L'IA amplifie vos forces
et vos faiblesses

-0.8%
de qualité de documentation par +25% d'adoption IA sans supervision
DORA 2024 · Confirmé par DORA 2025

Sans revue humaine, l'IA amplifie les mauvaises pratiques

@Victorlanglois
11 / 13
Risque mesuré

Sans supervision, la qualité baisse

-0.8%
de qualité de documentation par +25% d'adoption IA
DORA 2024

L'automatisation sans revue humaine dégrade la doc

@Victorlanglois
11 / 13
Insight DORA 2025

L'IA amplifie vos forces
et vos faiblesses

30%
des développeurs ont peu ou pas confiance dans le code généré par l'IA
DORA 2025 · State of AI-assisted Software Development

La qualité de votre documentation détermine la qualité des outputs IA

@Victorlanglois
11 / 13
Synthèse

Ce qu'il faut retenir

Points clés du cours 0803
Doc-as-Code : versionnée, revue, déployée
terraform-docs + IA pour le contexte narratif
L'IA structure, vous ajoutez le "pourquoi"
Jamais de merge auto sans revue humaine
@Victorlanglois
12 / 13
Prochaine étape

Cours 0804

La documentation devient la source de vérité.
Comment détecter la dérive quand l'infra réelle s'en écarte ?

@Victorlanglois
13 / 13