Avec l’IA, on parle beaucoup de la rapidité et de la vitesse de génération de code. Mais, tout comme le code, générer de la documentation n’a jamais été aussi simple et rapide. En quelques secondes, l’IA produit des pages entières décrivant un projet. Mais attention à cette abondance.
Comme beaucoup, je suis convaincu de l’importance de documenter: choix d’architecture, standard d’équipe, historique et choix des décisions. La documentation est primordiale pour maintenir la connaissance au fil du temps.
Mais une documentation générée automatiquement décrit généralement le “quoi” et le “comment”. Elle dresse un état des lieux de ce qui existe, mais elle ne permet pas d’avoir le “pourquoi”.
Pourquoi cette architecture plutôt qu’une autre ? Quel compromis a été accepté, dans quel contexte et avec quelles contraintes ? Quels ont été les autres choix étudiés.
Toutes ces informations n’existent pas dans le code, elles existent dans la tête de ceux qui ont fait les choix ou qui étaient présents. Ce n’est pas pérenne.
De plus, le risque de la génération automatique, c’est de passer d’un extrême à un autre. C’est passer d’une documentation pauvre ou inexistante à un bruit documentaire où tout est écrit, mais derrière l’abondance pas d’informations significatives.
C’est aussi une quantité de documentation que personne n’a relue, que personne ne s’est appropriées et que personne ne souhaite réellement maintenir.
Une documentation n’a de valeur que si elle porte une intention. L’IA peut aider à la rédaction, à la structuration et à sa maintenance. Mais la décision de ce qui mérite d’être documenté, et surtout de conserver l’historique de ce qui a mené aux différents choix restent de la responsabilité humaine.
L’IA peut générer des pages en quelques secondes. Mais une réflexion, elle, ne se génère pas. Elle se transmet.
