Générateur de changelog

Rien pour l'instant. Colle quelques lignes ci-dessus et clique sur Générer.

Ce qu'il fait avec chaque ligne

Les règles sont volontairement simples et visibles, pour que tu puisses prédire le résultat au lieu de le deviner :

1. Les conventional commits sont regroupés par type. `feat` devient Nouveautés, `fix` devient Corrections, `perf` devient Améliorations. Un `!` avant les deux-points, ou un marqueur BREAKING CHANGE, déplace la ligne vers Changements importants quel que soit le type.
2. Ce qui n'est pas un conventional commit est trié selon son premier mot. Les VERBES ANGLAIS habituels des commits sont reconnus : Add, Added, Introduce et Support deviennent Nouveautés ; Fix, Fixed et Resolve deviennent Corrections ; Improve, Update, Speed et Optimise deviennent Améliorations ; Remove, Removed, Drop et Deprecate deviennent Supprimé. Tout le reste atterrit dans Autre pour que tu le tries à la main.
3. Le bruit est retiré : un numéro de pull request en fin de ligne, une ligne `Merge pull request ...`, un scope entre parenthèses, et le préfixe de type lui-même. La phrase restante commence par une majuscule.
4. Avec le filtre activé, les lignes contenant `chore`, `ci`, `test`, `build`, `style` et `refactor` sont écartées, ainsi que tout ce qui ressemble à une montée de dépendance. C'est la plus grande différence entre un changelog qu'on lit et un qu'on arrête de lire.

Ce qu'il ne peut pas faire

Il change la forme de tes messages de commit, pas leur contenu. Si un commit dit `fix: race in MembershipCache.resolve()`, c'est ce qui ressort, et ça reste une phrase sur ton code plutôt que sur l'expérience de l'utilisateur. Transformer « race in MembershipCache » en « les membres invités ne voient plus un tableau de bord vide » demande de savoir ce que le changement a fait, ce qu'un générateur ne peut pas déduire d'une ligne d'objet de commit.

Traite donc le résultat comme un premier jet : la structure est correcte, le regroupement est correct, le bruit interne a déjà disparu, la rédaction reste ton travail.

Questions fréquentes

Est-ce que quelque chose de ce que je colle est envoyé quelque part ?

Non. Le générateur est un script sur cette page ; le texte ne quitte jamais ton navigateur et cliquer sur Générer n'envoie aucune requête vers nous. Tu peux le vérifier avec l'onglet réseau ouvert.

Dois-je utiliser des conventional commits ?

Non. Les lignes qui suivent la convention sont regroupées plus précisément, et tout le reste retombe sur le verbe initial. Un dépôt avec des messages de commit en phrases ordinaires produit quand même un brouillon utilisable.

Comment obtenir ça automatiquement depuis mon dépôt ?

Pour un usage ponctuel, `git log --pretty=format:%s v1.2.0..HEAD` donne exactement l'entrée attendue ici. Pour quelque chose de continu, git-cliff et github-changelog-generator construisent un fichier de changelog en CI à partir de ton historique de commits, et Changeloop rédige une entrée orientée utilisateur pour chaque pull request fusionnée et la garde pour relecture.

Pourquoi mon résultat est-il plein de Autre ?

Les verbes initiaux ne correspondaient à rien de connu, ce qui signifie généralement des objets de commit commençant par un nom ou un id de ticket. Modifie-les dans le champ avant de générer, ou déplace les lignes en Autre à la main ensuite.

Pour aller plus loin : Des conventional commits à un changelog, sur ce qu'apporte le format des commits et où il s'arrête.