{"slug": "comment-nommer-ses-branches-et-ses-messages-de-commit", "title": "Comment nommer ses branches et ses messages de commit ?", "summary": "This article provides guidelines for naming Git branches and writing commit messages. Branch names should follow a `//` format using kebab-case, while commit messages should adhere to the Conventional Commits standard with a structured format including type, scope, subject, body, and footer. These conventions improve codebase clarity, enable semantic versioning, and allow for automation of tasks like changelog generation.", "body_md": "Inspiré par [codeheroes](https://www.codeheroes.fr/2020/06/29/git-comment-nommer-ses-branches-et-ses-commits/)\n\n# Règles relatives aux messages de Commit\n## Nommer les branches\nEn dehors des branches develop et master, comment nommer nos autres branches ?\n\nRien de bien sorcier, nous allons simplement indiquer le type de la branche suivi du nom de celle-ci, optionnellement nous pouvons ajouter le numéro du ticket. Le tout doit être séparé par le caractère slash \"/\" :\n```\n//\n```\n## Les types de branches\n\n| Commit type | Desciption | Emoji |\n|:---------------------------|:----------------------------------------------|:------|\n| feature | Ajout d’une nouvelle fonctionnalité | ✨ |\n| bugfix | Correction d’un bug | 🐛 |\n| hotfix | Correction d’un bug critique | 🚑 |\n| chore | Nettoyage du code | 🧼 |\n| experiment | Expérimentation de fonctionnalités | 🚨 |\n\n## Le nom de la branche\nLe nom de la branche décrit succinctement le but de celle-ci. Certaines règles doivent être respectées :\n- Le nom doit faire moins de 50 caractères\n- Le nom doit respecter la convention kebab-case (les mots doivent être en minuscule et liés par des tirets “-“)\n\n## Le numéro de ticket\nPour le suivi de vos tickets, que ce soit sur Github, Gitlab ou tout autre outil comme JIRA par exemple,\nil peut être utile d’ajouter le numéro de ceux-ci dans le nom de vos branches. \nIl est ainsi possible par exemple de fermer automatiquement vos tickets lorsque la branche sera “merger”.\n\n## Quelques exemples\nVoyons quelques exemples de noms de branches pour mieux comprendre :\n```\nfeature/add-users-controller\nhotfix/profile-page-error/621\nexperiment/try-api-key\nchore/remove-deprecated-method/924\n```\n# Nommer les messages de commits\nLe message d’un commit doit être clair et concis, il doit indiquer ce qui a été modifié et la raison de cette modification.\nLa convention de nommage la plus utilisée est la “Conventional Commits“.\nL’avantage de respecter cette convention, outre le fait de rendre plus compréhensibles vos commits,\nest de permettre de respecter la sémantique de versions (SemVer) et d’automatiser certaines tâches \n(comme la génération d’un fichier Changelog par exemple).\n## Format des messages\nLe format du message est le suivant :\n```\n(): \n```\n```\n\n\n