La documentation prolonge la mémoire de l’équipe
Elle ne sert pas seulement à expliquer le système, mais à éviter que l’organisation redécouvre ce qu’elle sait déjà.
Une évolution fonctionnelle a fait apparaître une question inattendue : le modèle de données représentait-il déjà les différences de comportement entre plusieurs clients ?
Les deux collègues qui connaissaient le mieux cette zone étaient absents. Nous avons consulté les anciens tickets, la base et la documentation disponible, sans trouver de réponse suffisamment fiable.
Avec les éléments dont nous disposions, étendre le modèle semblait être la décision la plus sûre. Ce n’était pourtant pas un petit changement : il fallait toucher à la structure des données, développer, relire puis tester.
Quelques jours plus tard, un collègue est revenu. En moins d’une minute, il nous a indiqué que la colonne existait déjà. Nous avons retiré le changement.
La décision initiale n’était pas irrationnelle. Elle était cohérente avec ce que l’équipe pouvait vérifier à ce moment-là. Ce qui manquait n’était pas la connaissance, mais un moyen de la retrouver et de lui faire confiance.
C’est là que la documentation devient une mémoire collective. Elle ne décrit pas seulement le fonctionnement du produit ; elle aide à distinguer un besoin réellement nouveau d’une capacité déjà présente mais devenue invisible.
Quand cette distinction n’est plus possible, l’incertitude finit par produire de nouveaux développements. L’équipe reconstruit, non parce que rien n’existe, mais parce qu’elle ne peut pas s’appuyer sur ce qui existe.
Une bonne documentation ne cherche donc pas à tout conserver. Elle préserve surtout les repères qui permettront à la prochaine personne de savoir si elle doit inventer, retrouver ou simplement réutiliser.