# Un bon commit

Un commit raconte **un** changement. La règle pratique : si le message a besoin d'un « et », il fallait deux commits.

## Le message

| Message | Problème | Mieux |
| --- | --- | --- |
| `commit 2` | Ne dit rien | `Ajoute la fondation de ville par le colon` |
| `uploading whole project` | Tout est mélangé | Un commit par fonctionnalité |
| `fix` | On ne sait pas ce qui est corrigé | `Corrige l'ajout de la ferme à units_owned` |
| `wip` | Inutilisable dans six mois | `Ébauche le pathfinding, sans coût de terrain` |

Le message commence par un verbe et dit ce que le commit **fait**. Le « comment » est dans le code. Le « pourquoi » peut suivre sur une deuxième ligne quand il n'est pas évident.

Committer souvent ne coûte rien. Un bon rythme : chaque fois que le jeu marche et qu'on a avancé d'un pas.

## Ce qu'on ne committe pas

Le fichier `.gitignore` liste ce que Git doit ignorer. Celui du projet est déjà bien fait :

```text
.env
__pycache__/
.venv/
src/data
```

| On ignore | Pourquoi |
| --- | --- |
| Ce qui se régénère : `__pycache__/`, `.venv/`, `node_modules/` | Lourd, et différent sur chaque machine |
| Les secrets : `.env`, clés | Une fois poussés, ils sont publics pour toujours |
| Les données personnelles : `src/data`, les sauvegardes | Elles appartiennent au joueur, pas au projet |
