Journal de développement

Ce qui a été décidé, quand et pourquoi — revirements compris. Écrit au fil du travail, c’est pourquoi il contient ce qu’un compte rendu rétrospectif aurait gommé.

Le journal de développement consigne des décisions, pas des commits. Non pas ce qui a changé — l’historique du contrôle de version le dit déjà — mais pourquoi cela a changé ainsi, et ce que l’autre voie aurait coûté.

Il est écrit pendant le travail, pas reconstitué après coup. C’est ce qui le rend digne d’être lu, et parfois inconfortable : les revirements y sont aussi, avec la mesure qui les a imposés.

Le journal est un seul fichier continu dans le dépôt, publié ici année par année. Les entrées vont du plus récent au plus ancien, chacune datée, et chaque date vérifiable dans l’historique du dépôt.

Source : docs/JOURNAL.md dans le dépôt public — cette page en est une copie, pas un résumé.