Outils pour utilisateurs

Outils du site


Panneau latéral

linux:git_dev (lu 16045 fois)

Ceci est une ancienne révision du document !


Git dev

Convention de nommage

A chaque message de commit doit être associé un préfixe :

  • “feat” pour une nouvelle fonctionnalité / une évolution
  • “fix” pour la correction d’un bug
  • “docs” pour la mise à jour d’une documentation
  • “style” pour les changements qui n’affectent pas le fonctionnement du code (espaces, formattage, point-virgule manquants, etc…)
  • “refactor” pour une modification du code qui n’est ni un correctif, ni une évolution
  • “perf” pour une modification de code qui améliore les performances
  • “test” pour ajouter ou compléter un test
  • “chore” pour les changements du process de build ou d’une librairie / d’un outil tiers

Juste après le préfixe, il est possible de préciser le nom de la fonctionnalité impactée entre parenthèses (non obligatoire).
Puis le séparateur “:” doit apparaître.
Et enfin vous devez entrer un message de commit.

Exemples de messages de commit respectant ces conventions :
feat(profile form): add birthdate field
fix(profile form): fix birthdate validity check
refactor: remove console.log

Le nom des nouvelles branches créées doit respecter les règles suivantes :

Commencer par un préfixe précisant le type : “feat/” ou “fix/”

  • Le “slash” est important.
  • Contenir l’identifiant de l’application de gestion des bugs et évolutions
  • Les mots doivent être écrits en lettres minuscules
  • Les mots doivent être séparés par un tiret : “-”
  • Idéalement, utiliser l’anglais
  • Exemples :
  • feat/123456-my-new-feature
  • fix/123456-my-bug-fix

Pourquoi mettre un “slash” après “feat” ou “fix” ?
Cela permet d’avoir un nom de branche lisible qui ressemble à une arborescence de répertoire. Certains logiciels comme Gitkraken utilisent cette arborescence pour regrouper les features et les fixes.

Pourquoi des tirets plutôt que des underscores ?
Dans les normes de nommage les plus utilisées (pour les fichiers par exemple), c’est le tiret qui est privilégié. On reproduit donc ces normes dans le nom des branches.

– source: https://medium.com/codeshake/git-placez-le-rebase-au-centre-de-votre-strat%C3%A9gie-de-versioning-9b295e78e6ff

Gestion de branches pour le dev

Créer une branche

git checkout -b feat/nouvelle-fonctionnalité

Mettre à jour sa branche

git checkout feat/nouvelle-fonctionnalité
git rebase master
ou
git rebase -i master

Merger sa branche sur le master

git checkout master
git merge feat/nouvelle-fonctionnalité
git branch -d feat/nouvelle-fonctionnalité
linux/git_dev.1737217071.txt.gz · Dernière modification: 18-01-2025 17:17 de edmc73