Il existe de nombreuses manières d'utiliser git, certains étant plus adaptées que d'autres dans certaines situations. Nous verrons ici une méthode générique bien connue qui fonctionne dans la plupart des cas. Il est à noter que cet article s'adresse principalement à un public débutant avec git ou n'ayant jamais pris le temps de vraiment s'y intéresser.

Une branche par fonctionnalité

Afin de garder notre branche main (ou master) propre et permettre le développement parallèle de plusieurs fonctionnalités, nous prendrons l'habitude de toujours créer une branche pour chaque fonctionnalité ajoutée ou correction de bug. Cette bonne pratique est particulièrement recommandée lorsque plusieurs personnes travaillent sur le dépôt, mais pas uniquement. En effet, il arrive parfois qu'un bug critique soit signalé alors que vous avez du travail en cours… et là vous êtes bien content d'avoir fait une branche séparée qui attendra dans son coin que vous ayez corrigé le bug en question.

Pour créer une nouvelle branche, on utilisera switch avec l'option -c. Il est possible de lister les branches avec branch (la branche courante est indiquée par un astérisque *) et de naviguer entre elles avec switch.

$ git switch -c ma_nouvelle_branche
$ git branch
* ma_nouvelle_branche
  main
$ git switch main
$ git branch
  ma_nouvelle_branche
* main

Dans une branche, n'hésitez pas à faire des commits réguliers.

Fusionner une branche dans main

Une fois que l'on a terminé de travailler sur une branche, il ne reste plus qu'a la fusionner avec la main. Afin de garder un historique de commits propres, nous allons écraser tous les commits de la branche en un seul. Il ne reste alors plus qu'a détruire la branche devenue inutile.

$ git switch main
$ git merge --squash ma_nouvelle_branche
$ git status
$ git commit
$ git branch -D ma_nouvelle_branche

Entre le merge et le commit, pensez à vérifier que tout est en ordre.

Pour faire un bon commit, notez un court résumé sur la première ligne (50 caractères maximum) puis, sur les lignes suivantes (72 caractères maximum par ligne), expliquez en détail ce que fait le commit ainsi que pourquoi vous l'avez fait. Mettez à la fin des liens et autres références intéressantes.

Pour aller plus loin

• Utilisez l’étiquetage de git pour publier des versions ;
• Travailler avec les branches ;
• Comparing Workflows ;
• Git team workflows: merge or rebase? ;
• Simple Git workflow is simple ;
• How to Write a Git Commit Message.