Co dělá dobrý commit a dobrý commit message?

Question

Accepted Answer

Dobré commity jsou **zaměřené** (jedna logická změna) s **jasnými zprávami**, které vysvětlují, co se změnilo a proč. Dobře zpracované commity a zprávy činí historii projektu čitelnou, užitečnou pro porozumění změnám, ladění chyb a spolupráci.

## Dobré commit messages

```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
```

## Konvence imperatívu

```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).
```

## Dobré commity: atomické a zaměřené

```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 (populární standard)

```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.
```

## Proč to záleží

Porozumění tomu, co dělá dobré commity a commit messages, je cenné pro **vytváření čitelné a užitečné historie projektu**, takže jde o důležité praktické znalosti, které významně ovlivňují spolupráci a udržovatelnost. **Dobré commit messages** jsou důležité, protože historie commitů je klíčovou formou dokumentace — jasné zprávy (stručné shrnutí vysvětlující *co* se změnilo, s tělem vysvětlujícím *proč*, když je to potřeba) umožňují pochopit, jak a proč se kód vyvíjel, což je neocenitelné při prohlížení historie, ladění chyb (pochopení důvodu změny) nebo zapracování nových členů týmu.

Nejasné zprávy ("fixed stuff", "update", "wip") činí historii nepoužitelnou, takže je později nemožné pochopit změny — to je reálná cena.

**Konvence imperatívu** ("Add feature" místo "Added feature") je široce dodržovaný standard, který stojí za znalost. **To, že dobré commity jsou atomické a zaměřené** (každý commit jedna logická změna, ne více nesouvisejících změn najednou) je stejně důležité: zaměřené commity se **recenzují** mnohem snadněji (recenzenti rozumějí jedné změně), **revertují** (vrácení jedné změny bez ovlivnění ostatních), rozumějí a **bisektují** (hledání commitu, který zavedl chybu) — proto struktura commitu přímo ovlivňuje, jak je historie použitelná pro ladění a spolupráci.

Znalost **Conventional Commits** (standard `type(scope): description` umožňující automatické changelog a verzování) je cenná, protože je široce přijímán.

Protože historie commitů je důležitá dokumentace a dobré commity/zprávy ji činí čitelnou a užitečnou (pro porozumění, recenzi, ladění a spolupráci), zatímco špatné ji činí nepoužitelnou, a protože vytváření zaměřených commitů s jasnými zprávami je poznamaenáním profesionální praxe s Gitem, je porozumění tomu, co dělá dobré commity a commit messages, cenné, prakticky relevantní znalosti pro efektivní spolupráci a udržitelnou historii — dovednost, která odlišuje zvažující vývojáře a smysluplně zlepšuje dlouhodobou použitelnost a workflow týmu v projektu.