Comment utiliser : Générateur de changelog
- Exécutez la commande
git logindiquée ci-dessus dans votre dépôt, puis collez le résultat (hash et sujet sur chaque ligne). - Saisissez la version actuelle : la version de publication est proposée à partir des commits, ou vous pouvez saisir la vôtre.
- Choisissez les titres Conventional ou Keep a Changelog, et ajoutez l’URL de votre dépôt pour créer les liens vers les hashes de commit.
- Copiez le Markdown en haut de votre
CHANGELOG.mdou dans une release GitHub.
Conventional Commits en 30 secondes
Chaque sujet de commit commence par un type, un périmètre facultatif et une description : feat(cart): add coupon field. Un ! après le type ou le périmètre, ou une note BREAKING CHANGE:, signale une rupture de compatibilité.
| Type | Section | Incrément de version |
|---|---|---|
feat | Fonctionnalités / Added | Mineure |
fix | Corrections de bugs / Fixed | Patch |
perf | Performances | Patch |
feat!, BREAKING CHANGE | Ruptures de compatibilité | Majeure |
refactor, docs, style, test, build, ci, chore | Autres / masqués | Aucun |
revert | Annulations | Patch |
Keep a Changelog
Keep a Changelog classe les entrées destinées aux utilisateurs sous Added, Changed, Deprecated, Removed, Fixed, Security, la version la plus récente en premier, avec une section Unreleased en haut. Choisissez ce style si vos utilisateurs lisent le changelog plutôt que les développeurs.
Du changelog à la publication
Vérifiez la version proposée avec le Calculateur de version sémantique, mettez à jour version dans votre package.json, puis créez le tag et poussez la release : le Générateur de commandes Git vous donne les commandes. Un workflow GitHub Actions peut compiler et publier à chaque tag.
Aussi recherché comme : changelog conventional commits, keep a changelog, générateur de notes de version, changelog.md, git log changelog, notes de version semver, conventional commits.
Outils complémentaires : Générateur de changelog
- Générateur de Conventional Commits — Rédigez des messages de commit conformes à la spécification Conventional Commits sans la mémoriser.
- Générateur de fichiers README — Remplissez quelques champs et obtenez un projet épuré, prêt à être publié sur GitHub README.md — badges, installation, exemple d’utilisation, tableau de configuration, variables d’environnement, feuille de route et licence — avec un aperçu en direct et une vérification de l’exhaustivité.
- Validateur YAML — Collez un fichier Docker Compose, un manifeste Kubernetes, un workflow GitHub Actions ou tout autre YAML pour localiser les erreurs, repérer les pièges courants et obtenir une version proprement formatée.
- Générateur YAML Kubernetes — Renseignez le nom, l’image et le port de votre application pour obtenir du YAML Kubernetes prêt pour la production : un Deployment avec sondes, limites de ressources et contexte de sécurité renforcé, ainsi que le Service, l’Ingress avec TLS, le ConfigMap, le Secret et le HorizontalPodAutoscaler que vous cochez, le tout dans un seul fichier prêt pour kubectl apply.
Questions fréquentes
Quel format de git log dois-je coller ?
Idéalement, un commit par ligne avec le hash court en premier :
git log --pretty=format:"%h %s". Des sujets simples sans hash fonctionnent aussi. Les commits de fusion sont ignorés automatiquement.Comment la version suivante est-elle calculée ?
Tout changement incompatible incrémente la version majeure ; sinon, tout feat incrémente la version mineure ; sinon, les corrections et améliorations de performances incrémentent la version de patch. Pour les versions 0.x, les ruptures de compatibilité incrémentent la version mineure.
Que deviennent les commits qui ne suivent pas Conventional Commits ?
Ils sont listés sous « Autres modifications » (style Conventional) ou « Changed » (Keep a Changelog) afin de ne rien perdre. Supprimez simplement les lignes dont vous ne voulez pas dans le résultat.
Puis-je générer le changelog automatiquement en CI ?
Oui : des outils comme release-please, semantic-release ou changesets le font à chaque fusion. Ce générateur est pratique pour les petits projets, les publications manuelles ou pour vérifier ce que ces outils produiront.
Puis-je installer Générateur de changelog en tant qu’application web et l’utiliser hors ligne ?
Oui. Générateur de changelog est une application web installable (PWA) : elle s’installe depuis votre navigateur, sans passer par une boutique d’applications. Cliquez sur « Installer l’application » en haut de cette page dans Chrome ou Edge (Windows, macOS, Linux, ChromeOS) ; sur Android, utilisez « Partager » → « Ajouter à l’écran d’accueil » sur iPhone et iPad ; ou « Fichier » → « Ajouter au Dock » dans Safari 17+ sur Mac. L’application s’ouvre alors dans sa propre fenêtre avec sa propre icône, et comme elle s’exécute entièrement dans votre navigateur, elle continue de fonctionner hors ligne. Firefox sur ordinateur de bureau ne permet pas d’installer d’applications web. Comment fonctionne l’installation.