C'est dans la tête de Marc. Mais Marc est parti.
La phrase qui fait froid dans le dos de tout CTO.
Marc était le développeur principal. 5 ans sur le projet. Il connaissait tout. Chaque recoin du code. Chaque hack. Chaque "pourquoi c'est fait comme ça".
Marc est parti. Et avec lui, 5 ans de connaissance.
La situation post-Marc :
- Personne ne sait comment déployer
- Les variables d'environnement ? Mystère
- "Ce script là, faut pas y toucher" (mais pourquoi ?)
- 3 semaines pour onboarder un nouveau dev
- Peur de toucher à certains modules
Le coût réel de l'absence de documentation :
- ⏱️ Temps d'onboarding x3
- 🐛 Bugs liés à l'incompréhension du code
- 😰 Équipe stressée et démotivée
- 💸 Décisions techniques prises à l'aveugle
Ce qu'on a mis en place :
1. README actionnable
Pas un roman. Juste : comment installer, lancer, tester, déployer.
2. ADR (Architecture Decision Records)
"Pourquoi on utilise Redis ici ?" → Document de 10 lignes qui explique le contexte et la décision.
3. Schémas d'architecture
Un diagramme vaut 1000 mots. Miro, Draw.io, peu importe.
4. Comments sur le "pourquoi", pas le "quoi"
// Workaround bug Stripe webhook duplicate
// Voir ticket #1234
5. Onboarding doc
Checklist du nouveau développeur. Jour 1, jour 7, jour 30.
Résultat :
- ✅ Onboarding : de 3 semaines à 4 jours
- ✅ Autonomie des développeurs retrouvée
- ✅ Moins de "tu sais comment ça marche ?"
La leçon ?
Documenter, ce n'est pas perdre du temps. C'est acheter de l'assurance. 🎯
Le jour où votre "Marc" partira, vous serez prêt.
Votre équipe galère à comprendre le code existant ? L'onboarding est trop long ?
👉 Contactez-moi. Je vous aide à documenter efficacement votre application.