Qu'est-ce qui fait un bon commit et un bon message de commit ?

Question

Accepted Answer

Les bons commits sont **ciblés** (un seul changement logique) avec des **messages clairs** qui expliquent ce qui a changé et pourquoi. Des commits et des messages bien rédigés rendent l'historique du projet lisible, utile pour comprendre les changements, déboguer et collaborer.

## Bons messages de commit

```text
GOOD message structure:
  Short summary line (~50 chars, imperative mood, capitalized, no period)
  <blank line>
  Optional body: explain WHAT and WHY (not how — the code shows how),
  wrap at ~72 chars. Reference issues if relevant.
```

```text
✅ GOOD:
  Add user email validation to registration form

Validate email format before submission to prevent invalid
  accounts. Fixes #142.

❌ BAD:
  "fixed stuff", "update", "asdf", "changes", "wip"
  → vague, uninformative — useless when reviewing history later
```

## La convention du mode impératif

```text
Write the summary as a COMMAND/instruction (imperative):
  ✓ "Add feature", "Fix bug", "Update docs", "Remove dead code"
  ✗ "Added feature", "Fixes bug", "Updating docs"
→ Convention: it reads as "this commit will [Add feature]" (matches Git's own messages).
```

## Bons commits : atomiques et ciblés

```text
✓ ATOMIC — each commit is ONE logical change (not many unrelated changes lumped together)
✓ Focused — "Add login" and "Fix typo" are SEPARATE commits, not one
✓ Working — ideally each commit leaves the code in a working state
Why: focused commits are easier to REVIEW, REVERT (undo one change cleanly),
  understand, and bisect (find which commit introduced a bug).
```

## Conventional Commits (une norme populaire)

```text
type(scope): description    → feat: add login | fix: handle null | docs: update README
  types: feat, fix, docs, refactor, test, chore, etc.
→ Enables automated changelogs/versioning; widely adopted in many projects.
```

## Pourquoi c'est important

Comprendre ce qui fait de bons commits et de bons messages de commit est précieux pour **créer un historique de projet lisible et utile**, c'est donc une connaissance pratique importante qui affecte significativement la collaboration et la maintenabilité. **Les bons messages de commit** sont importants car l'historique des commits est une forme cruciale de documentation — des messages clairs (un résumé concis expliquant *ce qui* a changé, avec un corps expliquant *pourquoi* si nécessaire) permettent de comprendre comment et pourquoi le code a évolué, ce qui est inestimable lors de la révision de l'historique, du débogage (comprendre pourquoi un changement a été fait) ou de l'intégration de nouveaux membres.

Des messages vagues (« fixed stuff », « update », « wip ») rendent l'historique inutilisable, rendant impossible de comprendre les changements ultérieurement — un vrai coût.

La **convention du mode impératif** (« Add feature » et non « Added feature ») est une norme largement suivie qui vaut le coup de connaître. **Les bons commits étant atomiques et ciblés** (chaque commit une seule modification logique, pas plusieurs changements non liés regroupés ensemble) est tout aussi important : les commits ciblés sont beaucoup plus faciles à **réviser** (les relecteurs comprennent une seule modification), **revenir sur** (annuler une modification proprement sans affecter les autres), comprendre et **bissecter** (trouver quel commit a introduit un bug) — donc la structure des commits affecte directement l'utilité de l'historique pour le débogage et la collaboration.

Connaître les **Conventional Commits** (la norme `type(scope): description` permettant les changelogs et le versioning automatisés) est précieux car elle est largement adoptée.

Comme l'historique des commits est une documentation importante et les bons commits/messages le rendent lisible et utile (pour la compréhension, la révision, le débogage et la collaboration) tandis que les mauvais le rendent inutilisable, et comme créer des commits ciblés avec des messages clairs est une caractéristique de la pratique Git professionnelle, comprendre ce qui fait de bons commits et de bons messages de commit est une connaissance précieuse et pratique pour une collaboration efficace et un historique maintenable — une compétence qui distingue les développeurs réfléchis et améliore significativement l'utilité à long terme d'un projet et le flux de travail de l'équipe.