Mi jellemez egy jó commit-ot és commit üzenetet?

Question

Accepted Answer

A jó commit-ok **fókuszáltak** (egy logikai változás) és **világos üzenetekkel** rendelkeznek, amelyek elmagyarázzák, hogy mi és miért változott. A jól kidolgozott commit-ok és üzenetek olvashatóvá teszik a projekt előzményeit, hasznosak a változások megértéséhez, a hibakereséshez és az együttműködéshez.

## Jó commit üzenetek

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

## Az imperatívusz mód konvenciója

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

## Jó commit-ok: atomi és fókuszált

```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 (egy népszerű szabvány)

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

## Miért számít

Annak megértése, hogy mi jellemez jó commit-okat és üzeneteket, értékes az **olvasható, hasznos projekt előzmények létrehozásához**, ezért fontos praktikus tudás, amely jelentősen befolyásolja az együttműködést és a karbantarthatóságot. A **jó commit üzenetek** azért fontosak, mert a commit előzmények a dokumentáció döntő formája — az egyértelmű üzenetek (egy tömör összefoglalás, amely elmagyarázza, *mi* változott, egy szövegrésszel, amely szükség esetén elmagyarázza, *miért*) lehetővé teszik a kód fejlődésének megértését, amely felbecsülhetetlen értékű a történet áttekintésekor, a hibakereséskor (annak megértéséhez, hogy miért történt egy változás) vagy az új csapattagok betanításakor.

Az értelmetlenül fogalmazott üzenetek ("fixed stuff", "update", "wip") használhatatlanná teszik az előzményeket, lehetetlenné téve a változások későbbi megértését — ez valódi költség.

Az **imperatívusz mód konvenciója** ("Add feature" nem "Added feature") egy széles körben követett szabvány, amit érdemes ismerni. Az, hogy **a jó commit-ok atomi és fókuszáltak** (minden commit egy logikai változás, nem sok egymáshoz nem kapcsolódó változás összekeveredve), ugyanilyen fontos: a fókuszált commit-ok sokkal könnyebben **értelmezhetőek** (az értékelők egy változást értenek), **visszavonhatóak** (egy változás tiszta visszavonása anélkül, hogy másokat érintene), megérthetőek és **kétfelé oszthatóak** (annak megtudása, hogy melyik commit okozott hibát) — így a commit szerkezete közvetlenül befolyásolja a történet debug-oláshoz és együttműködéshez való felhasználhatóságát.

A **Conventional Commits** ismerete (a `type(scope): description` szabvány, amely automatizált changelog-okat és verziókezelést tesz lehetővé) értékes, mivel széles körben elfogadott.

Mivel a commit előzmények fontos dokumentáció, és a jó commit-ok/üzenetek olvashatóvá és hasznosabbá teszik azt (a megértés, áttekintés, hibakeresés és együttműködés szempontjából), míg a gyenge üzenetek használhatatlanná teszik, és mivel a fókuszált commit-ok és világos üzenetek elkészítése a professzionális Git-gyakorlat jellemzője, a jó commit-ok és üzenetek megértése értékes, praktikus tudás az eredményes együttműködéshez és karbantartható előzményekhez — olyan készség, amely megkülönbözteti a gondolkodó fejlesztőket, és érdemben javítja a projekt hosszú távú felhasználhatóságát és a csapatmunka munkafolyamatát.