Convention Git
GitNuro — client Git graphique utilisé par l'équipe pour visualiser les commits, gérer les branches et synchroniser le dépôt.
| Branche | Rôle |
|---|---|
main |
Version stable, toujours déployable |
develop |
Branche d'intégration des fonctionnalités |
feat/* |
Une branche par fonctionnalité, créée depuis develop
|
Exemples de noms de branches :
feat/home-page
feat/product-list
feat/product-details
feat/cart
- Se placer sur
developà jour :git checkout develop && git pull - Créer une branche dédiée :
git checkout -b feat/nom-de-la-feature - Développer, committer régulièrement
- Pousser la branche :
git push -u origin feat/nom-de-la-feature - Ouvrir une Pull Request vers
develop(voir Pull Request / Peer review) - Faire relire par au moins un autre membre de l'équipe (peer review)
- Fusionner après validation, puis supprimer la branche
main n'est mise à jour que depuis develop, à des étapes stables du projet (ex: fin de journée, avant démo).
Format recommandé :
type(scope): description courte
Exemples :
feat(product-list): ajoute l'affichage de la liste des produits
fix(cart): corrige le calcul du total du panier
style(header): ajuste le responsive du header
docs(readme): met à jour la procédure d'installation
Types courants : feat, fix, style, refactor, docs, chore.
- Commits réguliers et atomiques (un commit = un changement logique)
- Messages explicites, en français ou en anglais mais cohérents dans tout le projet
- Ne jamais commit directement sur
mainoudevelop - Pull Request avec une description claire (voir Pull Request / Peer review)