Changelog

Un changelog (litt. « journal des modifications »), est une liste des modifications, généralement présentées par ordre décroissant de commit, et groupées par version.

Il peut être distribué comme fichier avec le logiciel, inclus dans la documentation ou placé sur un portail destiné aux développeurs du projet.

Chaque entrée comporte des résumés succints des modifications, parfois accompagnées de métadonnées comme l'auteur, un identifiant de bug.

Historique

Ce terme est directement issu du monde des développeurs de logiciels, notamment celui des développeurs de logiciels libres, afin que tout le monde puisse savoir dans quelle direction le projet a évolué à travers le temps, quelle est sa vitalité (s'il avance beaucoup et vite, s'il est en plein essor, abandonné depuis un certain temps, ou seulement en phase de corrections de bugs). Dans tous les cas, cela constitue également une invitation à contribuer en sachant quelles sont les dernières évolutions, ce qu'il y a à tester…^{[Interprétation personnelle ?]}

Exemple

Ex. : pour un projet de comptabilité informatisée, on peut imaginer

ChangeLog
- Mise en conformité avec la terminologie du plan comptable (Vincent et Michel)
- Bugs d'affichage des graphiques d'équilibre des comptes corrigés (Gaby)
- Ajout de la fonction pour gérer plusieurs comptes (Sara)
- Réparation des éventuelles failles de sécurités lors des échanges par le réseau (Stéphane et Raoul)
- Orthographe dans la documentation (José)

Dans une situation idéale, les éléments présents dans un ChangeLog sont ceux prévus dans la todo list. En pratique, il y a généralement également de nombreuses corrections de bugs, dus a des erreurs humaines ou des imprévus de toutes sortes (composer un problème avec le système, un pilote, un problème matériel, situation non planifiée…) et les correctifs de sécurité.

Gestion de versions

Certains logiciels de gestion de versions sont capables de générer les informations applicables comme un changelog, typiquement celles issues des commandes traditionnelles diff et commit. En complément, un utilitaire comme vc-dwim permet de maintenir un fichier ChangeLog décrivant les modifications apportées aux fichiers sous contrôle de versions. Il est notamment compatible avec Git, mercurial, bzr, CVS et SVN.

Voir aussi

• Logiciel de gestion de versions