Discuter:Collective Code Ownership

Un article de Agile-Swiss.

A propos de la phrase "les développeurs doivent pondre une documentation exhaustive de leur développement"

Je préfèrerais que l'on dise Les développeurs doivent produire une batterie de tests automatisés qui couvrent l'ensemble des fonctionalités de leur développement. En effet, toute documentation est très vite démodée, et ceci dès la publication: le code est modifié par des demandes urgentes de la part des utilisateurs et les pauvres développeurs n'ont pas le temps de produire de la documentation qui ne leur est d'aucune utilité. Par contre, une batterie de tests automatisés est d'une grande utilité pour les développeurs. Il est donc plus facile de les inciter à en faire plutôt qu'une documentation. Et, grand bonheur, les tests automatisés restent toujours à jour et sont d'une utilité, non seulement grande, mais immédiate, aux développeurs suivants.

Didier Besset

les développeurs doivent pondre une documentation exhaustive de leur développement était bien dans mon esprit un contre exemple à éviter mais je l'ai peut être mal exprimé. Je suis tout a fait d'accord avec toi Didier sur le fait que les jeux de tests sont en eux-même la meilleure des documentations. A titre personnel je suis assez tenté de la compléter par un petit wiki sans ambition et le plus light possible (en terme de contenu) sur lequel l'ensemble de l'équipe contribue sur des aspects plus de synthèse. En effet les jeux de tests unitaires apportent une documentation très fine sur les classes mais par définition ne fournissent pas de vision synthétique sur l'ensemble de l'application(si c'est le cas il y d'ailleurs certainement un problème avec les tests unitaires ;-). Le wiki s'avère tellement simple d'utilisation (xp swiss en est un bon exemple) qu'on n'hésite moins à contribuer. C'est bien sûr à utiliser avec parcimonie mais ça me semble un bon complément.

Freddy