Comment nommer ses branches sur Git ?

Lorsque l'on utilise Git pour versionner son code et que l'on n'impose pas une convention de nommage généralisée, on perd très vite l'intérêt même d'utiliser un gestionnaire de versions.

Car après tout, comment retrouver facilement ses branches quand la moitié des noms ressemblent à "fix", "another-fix" ou "wtf" ?

Les branches

Je distingues trois types de branches sur un projet : Les branches globales, les branches personnelles et les branches de tâches.

Branches globales

Une branche globale est une branche qui n'est gérée que par un nombre très restreint de développeurs et qui a des conséquences sur les déploiements. On ne doit jamais coder directement dans ces branches, tout le code doit provenir de merge-requests qui auront subit une code-review au préalable.

Ces branches s'appellent en général : master, preprod, dev, ...

Les branches personnelles

Ces branches sont les branches principales sur lesquelles les développeurs travaillent en autonomie sur leur sprint respectif pour la version de dev actuelle.

Ces branches sont donc toutes nommées : dev/[prénom], dev/[initiales] ou encore dev/[prénom nom].

Les branches de tâches

Il arrive parfois qu'un ou plusieurs devs doivent travailler sur une tâche qui sort de leur workflow actuel, disons une correction de bug sur la version actuelle, alors que leur sprint porte sur la prochaine version de l'application.

Alors on créé une branche spécifique à cette tâche, basée sur la branche globale désirée, en prenant soin de préfixer le nom de la branche par le type de tâche à effectuer, exemples :

• fix/user-signup
• doc/missing-route
• ux/onboarding-improvement

Attention, pour garder un dépôt propre, l'idéal est de supprimer chaque branche de tâche une fois que cette dernière a été fusionnée avec une branche globale.

Si vous êtes intéressé.e par les conventions de nommage pour les commits, allez lire notre article dédié : https://code-garage.fr/blog/comment-bien-ecrire-vos-messages-de-commit