Conventional commits

Conventional Commits – Définitions

Les Conventional Commits sont une convention de formatage des messages de commit Git qui améliore la lisibilité, facilite la génération automatique de logs de version (changelogs) et permet le versioning sémantique (SemVer).

Chaque message de commit commence par un type suivi de deux-points et d’un espace, puis d’une description concise en minuscules :

Types principaux :

• feat: Ajout d’une nouvelle fonctionnalité (feature).
  Correspond à une augmentation de version mineure (SemVer x.y+1.z).
• fix: Correction de bug ou d’un problème existant.
  Correspond à une version patch (SemVer x.y.z+1).
• docs: Modifications relatives à la documentation (fichiers README, commentaires, guides, etc.), sans impact sur le code.
• chore: Tâches de maintenance, de configuration, ou liées à l’environnement de développement (mise à jour de dépendances, réglages d’outils, scripts de build, CI/CD, etc.).
  Ces commits ne modifient ni la logique métier ni la documentation utilisateur.
• refactor: Réorganisation ou amélioration du code sans changement fonctionnel (ni nouvelle feature, ni correction). L’objectif est d’améliorer la lisibilité, la performance ou la structure interne.
• style: Changements purement liés au formatage (indentation, points-virgules, espaces, etc.) sans modification de la logique.
• test: Ajout, modification ou correction de tests automatisés ou d’exemples (unitaires, d’intégration, etc.).

L’usage cohérent de ces types permet d’automatiser le versioning (via des outils comme Semantic Release) et de générer facilement des rapports de changements pour les équipes ou les utilisateurs.