Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
106 changes: 106 additions & 0 deletions CONVENTIONS.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,106 @@
# Git Convention Guide

## Commits (Conventional Commits)

### Format

```
type(scope?): description
```

### Types principaux

* `feat`: nouvelle fonctionnalité
* `fix`: correction de bug
* `refactor`: modification interne sans changement fonctionnel
* `style`: formatage / UI mineur (pas de logique)
* `docs`: documentation
* `test`: ajout/modification de tests
* `chore`: maintenance (deps, config…)
* `perf`: amélioration de performance
* `build`: build / dépendances
* `ci`: intégration continue

### Exemples

```
feat(auth): add login with CAS
fix(navbar): fix mobile display issue
refactor(api): simplify error handling
style(ui): adjust spacing in header
```

### Bonnes pratiques

* écrire à l’impératif → `add`, `fix`, `update`
* description courte (-50 caractères) et explicite
* un commit = une seule intention

### Breaking changes

L'ajour d'un point d'exclamation est possible pour signifier un breaking change.
```
feat!: remove old API
```

---

## Branches

### Format

```
type/short-description
```

### Types

* `feat/`
* `fix/`
* `refactor/`
* `chore/`
* `docs/`
* `perf/`
* `test/`

### Exemples

```
feat/login-page
fix/navbar-mobile
refactor/auth-hooks
```

### Bonnes pratiques

* utiliser kebab-case
* rester court et clair
* une branche = un objectif

---

## Choisir le bon type (exemple avec le frontend)

| Situation | Type |
| ------------------------ | -------- |
| Nouvelle feature visible | feat |
| Bug | fix |
| Refacto interne | refactor |
| Amélioration performance | perf |
| Ajustement visuel mineur | style |

---

## Exemple workflow

```
prod
└── feat/login-page
|── fix(auth): login-error
└── style(auth): color for 2026 edition
```

1. créer une branche depuis prod
2. faire des commits propres
3. ouvrir une pull request
4. merge après review
Loading
Loading