Skip to main content

GitBranch

Normes de nomenclature des branches​

Pour assurer une gestion claire et cohérente des branches, l'organisation Infrasoftbe adopte les conventions suivantes :

Branches principales​

  • main : Contient la version stable de production.
  • develop : Contient la dernière version en dĂ©veloppement actif. Toutes les nouvelles fonctionnalitĂ©s et corrections de bugs sont fusionnĂ©es ici avant de passer Ă  main.
danger

⚠️ Note importante​

La branche develop doit rester générique et ne pas être nominative (éviter les noms du type develop/<nom-du-développeur>).

Les branches doivent exclusivement être utilisées pour : Développer des fonctionnalités , Appliquer des corrections , Produire une release , Réaliser un hotfix , Créer un fork ou expérimenter ou Résoudre des conflits de merge.

Branches de fonctionnalités​

Utilisées pour développer de nouvelles fonctionnalités spécifiques.

  • Nom : feature/<nom-fonctionnalitĂ©>
  • Exemple : feature/amĂ©lioration-interface-utilisateur

Branches de correction​

Utilisées pour corriger des bugs dans les branches principales.

  • Nom : fix/<description-courte-bug>
  • Exemple : fix/correction-erreur-login

Branches de versions​

Utilisées pour préparer une version avant son déploiement.

  • Nom : release/<version> | <env>
  • Exemple : release/1.2.0 | dev - test - prod

Branches de hotfix​

Utilisées pour des corrections urgentes dans la version de production.

  • Nom : hotfix/<description-courte>
  • Exemple : hotfix/correction-critique

Branches expérimentales​

Pour expérimenter sans impacter les branches principales.

  • Nom : experiment/<nom-expĂ©rimentation>
  • Exemple : experiment/essai-nouvelle-librairie

Branches de merge​

Utilisées pour résoudre les conflits lorsque plusieurs branches doivent être fusionnées. Elles servent de zones temporaires pour effectuer un merge manuel.

  • Nom : merge/<source>-to-<cible>
  • Exemple : merge/feature-interface-to-develop

Ces branches doivent être supprimées après que le merge ait été correctement complété et validé.

Notifications et collaboration via Teams​

Teams a été configuré comme outil de communication pour suivre les changements dans les branches Git. Cela permet aux membres de l'équipe de rester informés des modifications sans avoir à surveiller manuellement chaque dépôt.

Configuration des notifications​

  • Teams est intĂ©grĂ© avec le dĂ©pĂ´t Git pour recevoir des notifications automatiques concernant les changements de branches.
  • Exemple de commande pour s'abonner Ă  une catĂ©gorie spĂ©cifique de branches :
subscribe <org-name>/<repo-name> commits:“release/*”

Cette commande permet d'observer toutes les branches correspondant à release/* et de recevoir des notifications en temps réel.

Bénéfices des normes et des filtres​

En combinant l'utilisation des normes de nomenclature des branches et les filtres de notification, l'Ă©quipe peut :

  • Identifier rapidement l'objectif d'une branche (grâce au nom standardisĂ©).
  • Rester au courant des activitĂ©s importantes (comme les mises Ă  jour dans release/*).
  • RĂ©duire les malentendus en recevant des notifications ciblĂ©es uniquement sur les branches pertinentes.

Meilleures pratiques​

  • Utilisez les conventions de nommage pour faciliter les recherches dans Teams.
  • Configurez des filtres dans Teams pour ne recevoir que les notifications pertinentes Ă  votre projet ou domaine.
  • Documentez les branches importantes dans vos rĂ©unions d'Ă©quipe pour assurer une synchronisation efficace.