Što čini dobar commit i poruku commita?

Question

Accepted Answer

Dobri commiti su **fokusirani** (jedna logička promjena) s **jasnim porukama** koje objašnjavaju što se promijenilo i zašto. Dobro izrađeni commiti i poruke čine povijest projekta čitljivom, korisnom za razumijevanje promjena, otklanjanje grešaka i suradnju.

## Dobre poruke commitanja

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

## Imperativni način govora - konvencija

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

## Dobri commiti: atomski i fokusirani

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

## Zašto je to važno

Razumijevanje što čini dobre commite i poruke commitanja vrijedno je za **stvaranje čitljive, korisne povijesti projekta**, pa je to važno praktično znanje koje značajno utječe na suradnju i održavnost. **Dobre poruke commitanja** su važne jer je povijest commitanja ključni oblik dokumentacije — jasne poruke (sažeta sažetak koji objašnjava *što* se promijenilo, s tijelom koje objašnjava *zašto* kada je potrebno) omogućuju razumijevanje kako i zašto se kod razvijao, što je neprocjenjivo pri pregledavanju zgodovine, otklanjanju grešaka (razumijevanju zašto je promjena napravljena) ili pri uvođenju novih članova tima.

Nejasne poruke ("fixed stuff", "update", "wip") čine povijest neupotrebljivom, čineći nemoguće razumijevanje promjena kasnije — to je pravi trošak.

**Imperativni način govora - konvencija** ("Add feature" umjesto "Added feature") je široko slijeđeni standard koji vrijedi znati. **Dobri commiti biti atomski i fokusirani** (svaki commit je jedna logička promjena, a ne mnogo nepovezanih promjena skupljenih zajedno) je jednako važno: fokusirani commiti su daleko lakši za **pregled** (recenzenti razumiju jednu promjenu), **vraćanje unazad** (poništavanje jedne promjene bez utjecaja na druge), razumijevanje i **bisecting** (pronalaženje koji je commit uveo bug) — pa struktura commita izravno utječe na to koliko je korisna povijest za otklanjanje grešaka i suradnju.

Znanje o **Conventional Commits** (standard `type(scope): description` koji omogućuje automatizirane changelog-e i verzioniranje) vrijedno je jer je široko prihvaćen.

Budući da je povijest commitanja važna dokumentacija i dobri commiti/poruke je čine čitljivom i korisnom (za razumijevanje, pregled, otklanjanje grešaka i suradnju) dok loši je čine neupotrebljivom, i budući da je stvaranje fokusiranih commitanja s jasnim porukama odlika profesionalne Git prakse, razumijevanje što čini dobre commite i poruke commitanja je vrijedna, praktično relevantna znanja za učinkovitu suradnju i održivanu povijest — vještina koja razlikuje promišljene razvojne inženjere i značajno poboljšava dugoročnu upotrebljivost projekta i tim tok rada.