Contribuer
Sémantique des commits
Merci d'utiliser le format suivant pour vos commits :
#ticket-id <message compréhensible du commit>
- Si vous êtes génés par un commit qui commence par
#
, qui sera considéré par un commentaire dans l'éditeur de texte, il suffit de préfixer ce commit par un 'espace'. - Éviter les messages comme
#100 update file
: ce message n'apporte aucun contexte sur le commit, impossible de savoir ce qui a été implémenté hormis le fait qu'il est lié au ticket 100. - Éviter de nombreux commits dans une même Merge Request. Utiliser git rebase pour renommer ou fusionner des commits.
- Éviter les mot-clés comme 'wip' dans les commits.
Changelog
- Chaque Merge Request qui correspond à un changement visible par l'utilisateur doit apparaitre dans le fichier CHANGELOG.md
- Suffixer chaque changelog par la référence (!merge-request-id) de la Merge Request. Exemple : - voici une modification dans le changelog (!mr)
- Si plusieus Merge Requests correspondent à un même changement dans une même version (exemple : une 'feature' suivi par un 'bugfix'), préférer n'avoir qu'une seule ligne suivie des références des Merge Request, comme ceci (!mr1, !mr2).