Kaj naredi dober commit in sporočilo commita?

Question

Accepted Answer

Dobri commiti so **osredotočeni** (ena logična sprememba) s **jasnimi sporočili**, ki pojasnjujejo, kaj se je spremenilo in zakaj. Dobro oblikovani commiti in sporočila naredijo zgodovino projekta berljivo, uporabno za razumevanje sprememb, odpravljanje napak in sodelovanje.

## Dobra sporočila commitov

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

## Konvencija imperativa

```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 in osredotočeni

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

## Zakaj je to pomembno

Razumevanje, kaj naredi dobre commite in sporočila commitov, je dragoceno za **ustvarjanje berljive in uporabne zgodovine projekta**, zato je to pomembno praktično znanje, ki bistveno vpliva na sodelovanje in vzdrževalnost. **Dobra sporočila commitov** so pomembna, ker je zgodovina commitov ključna oblika dokumentacije — jasna sporočila (kratek povzetek, ki pojasnjuje *kaj* se je spremenilo, s telesom, ki pojasnjuje *zakaj*, ko je potrebno) omogočajo razumevanje, kako in zakaj se je koda razvijala, kar je neprecenljivo pri pregledovanju zgodovine, odpravljanju napak (razumevanje, zakaj je bila sprememba narejena) ali vpeljavi novih članov.

Neosredotočena sporočila ("popravljeno stvari", "posodobljeno", "work in progress") naredijo zgodovino neuporabno, kar onemogoča razumevanje sprememb pozneje — to je pravi strošek.

**Konvencija imperativa** ("Dodaj funkcionalnost" namesto "Dodal funkcionalnost") je široko sledeni standard, ki ga je vredno poznati. **Dobri commiti, ki so atomski in osredotočeni** (vsak commit je ena logična sprememba, ne več nepovezanih sprememb skupaj) je enako pomembno: osredotočeni commiti so veliko lažje za **pregledovanje** (pregledovalci razumejo eno spremembo), **povrnitev** (ukinitev ene spremembe čisto, brez vpliva na druge), razumevanje in **bisekcijo** (iskanje, kateri commit je uvedel napako) — zato struktura commita neposredno vpliva na to, kako uporabna je zgodovina za odpravljanje napak in sodelovanje.

Znanje o **Conventional Commits** (standard `type(scope): description`, ki omogoča avtomatiziran changelog in verzioniranje) je dragoceno, ker je široko sprejet.

Ker je zgodovina commitov pomembna dokumentacija in dobri commiti/sporočila jo naredijo berljivo in uporabno (za razumevanje, pregledovanje, odpravljanje napak in sodelovanje), medtem ko slabi jo naredijo neuporabno, in ker je oblikovanje osredotočenih commitov s jasnimi sporočili značilnost profesionalne Git prakse, je razumevanje, kaj naredi dobre commite in sporočila commitov, dragoceno, praktično relevantno znanje za učinkovito sodelovanje in vzdržljivo zgodovino — veščina, ki loči premisljenega razvijalca in bistveno izboljša dolgoročno uporabnost projekta in delovanje ekipe.