Générateur de Changelog

Écrire des changelogs à la main signifie parcourir le git log au moment de la publication. Ce générateur évite cette étape : vous collez directement les entrées à publier sous la bonne catégorie, Ajouté, Modifié, Corrigé et Supprimé, ajoutez un numéro de version et une date, et il produit une section markdown conforme à Keep a Changelog, prête à être intégrée dans CHANGELOG.md. Le même contenu peut aussi être généré en texte brut. Il ne lit pas votre historique git ; c’est vous qui décidez quelles modifications entrent dans la version.

Comment générer un changelog

  1. 1

    Saisissez la version et la date

    Saisissez le numéro de version, par exemple 1.2.0. Laissez la date vide pour utiliser la date du jour.

  2. 2

    Ajoutez des entrées par catégorie

    Collez les notes de version sous Ajouté, Modifié, Corrigé et Supprimé, une entrée par ligne. Les catégories vides sont ignorées.

  3. 3

    Choisissez le format de sortie

    Markdown (un en-tête `## [version] - date` avec des sections de type `### Added`) ou texte brut (un en-tête `v1.2.0 (date)` avec des listes à puces).

  4. 4

    Copiez le changelog

    Collez la sortie au-dessus de l'entrée précédente dans CHANGELOG.md.

Les quatre catégories

Le générateur produit exactement quatre sections, dans cet ordre : Added, Changed, Fixed et Removed. Les titres de sections de la sortie restent en anglais, le libellé standard de Keep a Changelog.

Catégorie Quand l’utiliser
Added Nouvelles fonctionnalités
Changed Modifications de fonctionnalités existantes
Fixed Corrections de bogues
Removed Fonctionnalités supprimées

La convention Keep a Changelog prévoit aussi les sections Deprecated, Security et Breaking. Le générateur n’a pas de champs pour elles ; vous pouvez ajouter ces sections à la main après avoir collé la sortie.

Exemple de sortie (Markdown)

## [1.4.0] - 2026-04-18

### Added
- Dark mode support for the dashboard (#312)
- CSV export on the users page (#318)

### Changed
- Upgrade React to 18.3 (#320)
- Pagination now defaults to 50 items per page (#322)

### Fixed
- Crash when editing users with a null email (#319)
- Timezone offset in scheduled reports (#321)

### Removed
- Legacy reports API (#324)

Exemple de sortie (texte brut)

v1.4.0 (2026-04-18)
ADDED:
  • Dark mode support for the dashboard (#312)
  • CSV export on the users page (#318)
CHANGED:
  • Upgrade React to 18.3 (#320)
  • Pagination now defaults to 50 items per page (#322)
FIXED:
  • Crash when editing users with a null email (#319)
  • Timezone offset in scheduled reports (#321)
REMOVED:
  • Legacy reports API (#324)

Conseils

  • Une entrée par ligne. Chaque ligne d’un champ devient une puce. Les champs vides sont ignorés, et vous pouvez laisser une catégorie entière vide.
  • Rédigez les entrées comme des lignes de changelog, pas comme des notes de journal. L’impératif « fix: handle null email on edit » se lit bien comme une puce.
  • Référencez les numéros d’issue/PR pour que les lecteurs puissent creuser : (#319) ou [#319](link) dans la sortie.
  • Une version par entrée : ne fusionnez pas deux versions dans un même bloc, même si elles ne sont séparées que d’un jour.
  • Publié ou non publié : gardez une section [Non publié] en haut avec les modifications destinées à la prochaine version. Déplacez-les dans une section datée lors de la publication.

Questions fréquentes

Les conventions de Keep a Changelog (keepachangelog.com) : un en-tête de version avec une date et des listes à puces groupées. Le générateur produit les sections Added, Changed, Fixed et Removed ; les autres sections standard (Deprecated, Security, Breaking) suivent la même convention si vous les ajoutez à la main.

Le générateur produit les quatre sections principales : Added, Changed, Fixed et Removed. Il n’y a pas de champs dédiés à Deprecated, Security ou Breaking, mais vous pouvez ajouter ces sections manuellement au texte généré avant de le coller.

Le générateur est un outil d’interface à usage unique ; pour l’automatisation, utilisez un CLI comme standard-version, release-please ou semantic-release, qui implémentent les mêmes modèles dans votre pipeline de construction.

Non. Il ne lit ni votre dépôt ni vos messages de commit ; vous collez vous-même les entrées. Le texte que vous saisissez est envoyé au serveur pour construire la sortie et n’est ni stocké ni partagé.

Outils similaires