Envoyé par
sevyc64
Le genre de commentaire que, personnellement, je considère justement parfaitement inutile (et je sais de quoi je parle, j'en ai gérer pendant plusieurs années pour un client). La notion d'auteur peut être très vague lorsqu'on est dans une équipe de plusieurs développeurs, voire dans une boite comportant plusieurs équipes de plusieurs développeurs. Et si en plus en considère le turn-over de la boite .... Sauf à y renseigner l'annuaire, ça sert pas à grand chose.
Les notions de modifications, dernière modification, etc, sont souvent rarement à jour au delà de la 4 ou 5ème version du fichier, surtout lorsque les entêtes en question concerne à la fois le fichier lui-même mais aussi chaque méthode dans le fichier.
De plus, dans une structure organisée, qui possède un gestionnaire de source type svn ou github, ce genre de commentaire est rendu obsolète par le gestionnaire de source, bien plus efficace à ce niveau là.
Mais après, effectivement, chacun voit son propre intérêt dans sa façon de faire.
Pour le cas que j'ai eu à gérer durant plusieurs années, sur ce point là et sur la doc qui allait avec, il n'était pas rare qu'il me faille 1/2h pour faire une modif, et ensuite 3 jours pour gérer toutes ces notions de versions, tant dans les sources que sur la doc qu'il fallait modifier entièrement. Sans compter les tests, qui, au delà du test fonctionnel de la modif, consistaient à redérouler l'entièreté des tests pour la non régression, une inspection de code, un file-compare, une relecture complète de la doc, ...
Bref rien de très productif.
Alors qu'avec un gestionnaire de source, il suffit de produire un rapport d'évolution entre les 2 releases, ça prend 30sec !
Partager