# 08 — Commits et historique

🌍 [English](../../en/08-commits-and-history/readme.md) · [Türkçe](../../tr/08-commits-and-history/readme.md) · [Deutsch](../../de/08-commits-and-history/readme.md) · **Français** · [Русский](../../ru/08-commits-and-history/readme.md)

Un commit est une étape enregistrée : ce qui a changé, qui l'a changé, quand et pourquoi.

## Écrire un bon message

```
ajouter les notes de configuration VLAN
corriger l'adresse de passerelle erronée dans le readme
supprimer la capture de paquets inutilisée
```

- Une ligne, au présent, sans point final.
- Dites *ce que fait* la modification, pas « mise à jour » ou « corrections diverses ».
- Une explication plus longue ? Mettez-la dans le champ description sous le résumé.

## Bien commiter

- **Une idée par commit.** Deux changements sans rapport, ce sont deux commits.
- **Commitez souvent.** Les petits pas sont faciles à relire et faciles à annuler.
- **Ne commitez jamais de mots de passe, de clés ni de jetons.** Les retirer plus tard ne les retire pas de l'historique — il faut changer le secret lui-même.

## Lire l'historique

| Où | Ce que vous obtenez |
|----|---------------------|
| Bouton **Historique** sur un dossier ou un fichier | Tous les commits qui l'ont touché |
| La page d'un commit | Le diff complet : rouge supprimé, vert ajouté |
| **Blame** sur un fichier | Quel commit a modifié chaque ligne en dernier |
| Onglet **Activité** | Graphe des contributions dans le temps |

## Annuler

- **Un commit était mauvais** → ouvrez-le, cliquez sur **Revert**. Cela crée un nouveau commit qui l'annule ; rien n'est effacé.
- **Un fichier était mauvais** → ouvrez son historique, affichez la bonne version, recopiez le contenu et commitez.
- **Un commit n'est pas encore poussé** (travail depuis votre ordinateur) → `git commit --amend` pour corriger le dernier avant de le partager.

## Comparer

Ajoutez `/compare/main...ma-branche` à l'URL du dépôt, ou utilisez le bouton **Comparer**, pour voir toutes les différences entre deux branches ou étiquettes.

---

⬅ [Précédent: 07 — Images et pièces jointes](../07-images-and-media/readme.md) · 📚 [Sommaire](../README.md) · [Suivant: 09 — Branches et demandes de fusion](../09-branches-and-pull-requests/readme.md) ➡