Quotidien Shaarli

Tous les liens d'un jour sur une page.

October 29, 2018

Tenez un Changelog

Ne laissez pas vos amis utiliser les logs git comme changelogs

Qu'est-ce qu'un changelog ?

Un changelog (journal des modifications) est un fichier qui contient une liste triée chronologiquement des changements notables pour chaque version d’un projet

Pourquoi tenir un changelog ?

Pour permettre aux utilisateurs et contributeurs de voir précisément quels changements notables ont été faits entre chaque publication (ou version) d'un projet.

Qui a besoin d'un changelog ?

Tout le monde. Qu'ils soient consommateurs ou développeurs, les utilisateurs de logiciels sont des êtres humains qui se soucient de connaître le contenu des logiciels qu'ils utilisent. Quand un logiciel change, ces mêmes personnes veulent savoir comment et pourquoi.


À mettre en parallèle de la Gestion sémantique de version 2.0.0 : https://semver.org/lang/fr/spec/v2.0.0

Étant donné un numéro de version MAJEUR.MINEUR.CORRECTIF, il faut incrémenter :
le numéro de version MAJEUR quand il y a des changements non rétrocompatibles,
le numéro de version MINEUR quand il y a des changements rétrocompatibles,
le numéro de version de CORRECTIF quand il y a des corrections d’anomalies rétrocompatibles


Édition 2020-12-06 : à mettre en parallèle du "Commits Conventionnels"