Auto-évaluation : maturité documentation

Où en êtes-vous vraiment avec votre documentation ?

Ce questionnaire vous permet d’évaluer objectivement votre niveau de maturité et d’identifier les priorités d’amélioration.

Répondez honnêtement — c’est un diagnostic, pas un examen.

Le questionnaire

Section 1 : Existence et couverture

Q1. Vos services critiques ont-ils un Service Overview ?

A — Tous les services critiques (100%)
B — La plupart (50-99%)
C — Quelques-uns (< 50%)
D — Aucun ou presque

Q2. Avez-vous des runbooks pour les incidents fréquents ?

A — Oui, couvrant 80%+ des incidents
B — Oui, pour les principaux (50-80%)
C — Quelques-uns éparpillés
D — Non ou très peu

Q3. Les postmortems sont-ils documentés après les incidents majeurs ?

A — Systématiquement (100% des P1/P2)
B — Souvent (50-99%)
C — Parfois (< 50%)
D — Rarement ou jamais

Section 2 : Accessibilité

Q4. Combien de temps faut-il pour trouver une doc spécifique ?

A — < 1 minute (URL connue ou search efficace)
B — 1-5 minutes
C — 5-15 minutes
D — > 15 minutes ou “demander à quelqu’un”

Q5. La documentation est-elle centralisée ?

A — 1 URL unique pour toute la doc technique
B — 2-3 emplacements bien identifiés
C — Plusieurs endroits, pas toujours clair
D — Éparpillée (wiki, Drive, Slack, READMEs…)

Q6. La recherche fonctionne-t-elle bien ?

A — Search full-text rapide et pertinent
B — Search basique mais utilisable
C — Search limité, navigation par dossiers
D — Pas de search ou inutilisable

Section 3 : Maintenance

Q7. Chaque document a-t-il un owner identifié ?

A — Oui, écrit dans chaque document
B — Oui pour la plupart
C — Parfois, pas systématique
D — Non, “c’est l’équipe”

Q8. Les documents sont-ils reviewés régulièrement ?

A — Oui, cycle de review défini et respecté
B — Parfois, de manière ad-hoc
C — Rarement
D — Jamais après création

Q9. Quel âge a la doc la plus obsolète que vous connaissez ?

A — < 6 mois (tout est relativement frais)
B — 6-12 mois
C — 1-2 ans
D — > 2 ans ou “je ne sais pas”

Section 4 : Utilisation

Q10. La doc est-elle utilisée pendant les incidents ?

A — Systématiquement, c’est le premier réflexe
B — Souvent
C — Parfois, si on y pense
D — Rarement, on préfère appeler quelqu’un

Q11. Les nouveaux consultent-ils la doc pour l’onboarding ?

A — Oui, parcours d’onboarding basé sur la doc
B — Oui, comme ressource complémentaire
C — Un peu, mais surtout du shadowing
D — Non, formation orale uniquement

Q12. La doc est-elle mise à jour après les incidents ?

A — Systématiquement (action item du postmortem)
B — Souvent
C — Parfois
D — Rarement ou jamais

Section 5 : Processus

Q13. La documentation fait-elle partie de la Definition of Done ?

A — Oui, checklist obligatoire dans les PRs
B — Oui, mais pas toujours respecté
C — Non, c’est optionnel
D — Non, “on documentera plus tard”

Q14. Y a-t-il des templates pour les différents types de docs ?

A — Oui, templates standardisés et utilisés
B — Quelques templates existent
C — Non, chacun fait à sa façon
D — Non, pas de structure définie

Q15. La doc est-elle versionnée (Git ou équivalent) ?

A — Oui, Docs-as-Code avec review PR
B — Oui, versioning basique
C — Historique wiki limité
D — Non, pas de versioning

Calculez votre score

Comptage

Réponse	Points
A	4 points
B	3 points
C	2 points
D	1 point

Votre score total : ___ / 60

Interprétation

Score 50-60 : Niveau Expert 🏆

Votre documentation est exemplaire. Vous avez mis en place les bonnes pratiques et elles sont respectées.

Prochaines étapes :
- Partager vos pratiques avec d’autres équipes
- Automatiser davantage (CI/CD, tests)
- Mesurer l’impact (métriques d’usage)
Score 35-49 : Niveau Avancé ⭐

Bonne base en place. Quelques améliorations permettraient d’atteindre l’excellence.

Prochaines étapes :
- Identifier les 2-3 questions où vous avez C ou D
- Prioriser les améliorations sur ces points
- Formaliser les processus (ownership, review)
Score 20-34 : Niveau Intermédiaire 📈

Des efforts ont été faits mais la documentation n’est pas encore un réflexe ancré dans l’équipe.

Prochaines étapes :
- Centraliser la documentation (1 URL)
- Définir l’ownership pour les docs existantes
- Intégrer la doc dans la DoD
- Créer les templates manquants
Score < 20 : Niveau Initial 🚀

La documentation est un chantier à lancer. C’est le bon moment pour partir sur de bonnes bases.

Prochaines étapes :
- Commencer par le minimum vital (3 Service Overviews)
- Choisir un outil et centraliser
- Former l’équipe aux bonnes pratiques
- Quick wins : 1 runbook pour l’incident le plus fréquent

Plan d’amélioration par domaine

Si vous êtes faible sur “Existence et couverture” (Q1-Q3)

Priorité : créer le contenu manquant

Action	Effort	Impact
Service Overview services critiques	2h/service	Élevé
Runbook incident le plus fréquent	2h	Élevé
Template postmortem	1h	Moyen

→ Guide : Service Overview

Si vous êtes faible sur “Accessibilité” (Q4-Q6)

Priorité : centraliser et rendre trouvable

Action	Effort	Impact
Choisir 1 outil et migrer	1-2 jours	Élevé
Configurer le search	2h	Élevé
Créer la page d’accueil/index	1h	Moyen

→ Guide : Choisir ses outils

Si vous êtes faible sur “Maintenance” (Q7-Q9)

Priorité : instaurer les processus

Action	Effort	Impact
Assigner un owner à chaque doc	2h	Élevé
Planifier review trimestrielle	1h	Moyen
Ajouter date dans les docs	1h	Moyen

→ Guide : Ownership

Si vous êtes faible sur “Utilisation” (Q10-Q12)

Priorité : ancrer l’habitude

Action	Effort	Impact
Lier les alertes aux runbooks	2h	Élevé
Créer parcours onboarding	4h	Élevé
Ajouter “màj doc” dans postmortem	30min	Moyen

→ Guide : Reviews et fraîcheur

Si vous êtes faible sur “Processus” (Q13-Q15)

Priorité : formaliser

Action	Effort	Impact
Ajouter checklist doc dans PR template	30min	Élevé
Créer les templates	4h	Élevé
Migrer vers Docs-as-Code	1-2 jours	Moyen

→ Guide : 5 familles de documentation

Refaire l’évaluation

Date	Score	Niveau	Notes
[Date]	/60
+6 mois	/60
+12 mois	/60