Types de Commits pour PyMoX⚓︎

Ce document décrit les différents types de commits que vous pouvez utiliser dans ce projet et leur impact sur la versionnage sémantique.

Types de Commits et Versionnage⚓︎

Déclenchent une version MAJEURE (x.0.0)⚓︎

feat!: - Nouvelle fonctionnalité avec changement incompatible
Tout commit avec BREAKING CHANGE: dans le corps du message

Déclenchent une version MINEURE (0.x.0)⚓︎

feat: - Nouvelle fonctionnalité
upgrade: - Amélioration d'une fonctionnalité existante
maj: - Mise à jour majeure (mais pas incompatible)

Déclenchent une version PATCH (0.0.x)⚓︎

Corrections et améliorations⚓︎

fix: - Correction de bug
hotfix: - Correction urgente
patch: - Correction mineure
correct: - Correction générale
revert: - Annulation d'un changement précédent

Performance et optimisation⚓︎

perf: - Amélioration de performance
optimize: - Optimisation du code
enhance: - Amélioration générale

Code et structure⚓︎

refactor: - Refactorisation qui ne change pas le comportement
style: - Changements de formatage (espaces, indentation, etc.)
clean: - Nettoyage du code
format: - Formatage du code
lint: - Corrections de linting

Interface et expérience utilisateur⚓︎

ui: - Modifications de l'interface utilisateur
ux: - Améliorations de l'expérience utilisateur
tweak: - Petits ajustements d'interface
adjust: - Ajustements mineurs

Contenu et documentation⚓︎

doc: - Changements dans la documentation
content: - Mise à jour du contenu
i18n: - Internationalisation et traductions
typo: - Correction de fautes de frappe

Mises à jour et maintenance⚓︎

up: - Petites mises à jour
update: - Mises à jour générales
deps: - Mise à jour des dépendances
security: - Corrections de sécurité
config: - Modifications de configuration
meta: - Métadonnées et informations du projet
misc: - Divers changements mineurs

Ne déclenchent PAS de nouvelle version⚓︎

Tout commit sans format type: ne déclenche aucune nouvelle version.

Exemples : - Ajout de nouvelles fonctionnalités - Correction de bugs - Mise à jour - WIP: travail en cours - Refactoring du code - Tests ajoutés

Principe : Si vous ne voulez pas déclencher de version, n'utilisez simplement pas le format type: description.

Exemples d'utilisation⚓︎

Text Only

feat: ajout d'une nouvelle fonctionnalité de recherche

Text Only

fix: correction du problème d'affichage sur mobile

Text Only

doc: mise à jour du guide d'installation

Text Only

feat!: refonte complète de l'API

BREAKING CHANGE: L'ancienne API n'est plus compatible

Text Only

improvement: optimisation des performances de chargement

Text Only

content: ajout de nouveaux exemples dans la documentation

Text Only

ui: amélioration du contraste des boutons

Text Only

i18n: ajout de la traduction en espagnol

Text Only

typo: correction des fautes dans la page d'accueil

Text Only

optimize: amélioration des temps de chargement

Text Only

config: mise à jour de la configuration MkDocs

Text Only

deps: mise à jour de Material for MkDocs vers v9.5.0

Text Only

security: correction de vulnérabilité dans les dépendances

Text Only

clean: suppression du code mort dans les templates

Text Only

hotfix: correction urgente du lien cassé en production

Conseils pour de bons messages de commit⚓︎

Utilisez l'impératif présent : "add" plutôt que "added"
Ne mettez pas de point à la fin de la première ligne
Limitez la première ligne à 72 caractères
Après la première ligne, ajoutez une ligne vide puis une description détaillée si nécessaire
Utilisez des listes à puces dans la description si approprié

Les différents types de commits⚓︎

Emoji	Sens	Usage suggéré
🕒	Dernières modifications	"Last commits" chronologiques
📦	Livraison de code	Commit d’une feature ou d’un fix
🧠	Travail réfléchi ou complexe	Commits stratégiques ou techniques
🔄	Mise à jour	Commit de refacto ou d’update
📝	Journal / historique	Liste des derniers commits
🧬	Changement dans l’arborescence	Commit impactant la structure du code
🗂️	Fichiers	Plusieurs commits sur différents fichiers