Dans le monde du logiciel (libre en particulier), il est normal de proposer un changelog et une todo list.

Le changelog, c’est le journal de bord des modifications effectuées, la liste de tous les travaux terminés. Le niveau de détail varie selon le projet: parfois on se réfère à un numéro qui donnera plus d’infos, parfois on commente beaucoup, parfois on liste simplement.

La todo list, c’est la liste de ce qui reste à faire. C’est elle qui donne la direction que prendra le projet. Elle sera à la fois d’aide-mémoire pour les auteurs du projet et d’indicateur pour ses utilisateurs.

C’est assez banal, au fond. On dit ce que l’on a fait et, en général, pourquoi. On dit ce que l’on souhaite faire. Banal mais rare!

Dès que l’on sort du développement informatique, par exemple pour passer dans le monde du texte, les projets bien documentés sont difficiles à trouver. C’est peut-être une attitude, on ne souhaite pas forcément partager, pas forcément collaborer. Mais, surtout, on refuse de donner à son travail une histoire et un avenir.

Ce qui est particulièrement intéressant, c’est que ces fichiers, ces listes, ne sont pas des annexes, mais font partie intégrante du projet. On attend encore un livre qui intégrerait un vrai changelog pour sa seconde édition.

Vous aurez remarqué, si vous avez suivi les liens ci-dessus, que des systèmes complets (et parfois complexes) existent pour suivre la vie d’un projet. Ce sera le cas d’un prochain billet…