Vad gör ett bra commit och ett bra commit-meddelande?

Question

Accepted Answer

Bra commits är **fokuserade** (en logisk förändring) med **tydliga meddelanden** som förklarar vad som ändrades och varför. Väl utformade commits och meddelanden gör projekthistoriken läsbar och användbar för att förstå ändringar, felsöka och samarbeta.

## Bra commit-meddelanden

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

## Konventionen för imperativ modus

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

## Bra commits: atomära och fokuserade

```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 (en populär 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.
```

## Varför det är viktigt

Att förstå vad som gör commits och commit-meddelanden bra är värdefullt för att **skapa läsbar och användbar projekthistorik**, så det är praktisk kunskap som är viktig och som påverkar samarbete och underhållbarhet betydligt. **Bra commit-meddelanden** är viktiga eftersom commit-historiken är en viktig form av dokumentation — tydliga meddelanden (en kortfattad sammanfattning som förklarar *vad* som ändrades, med en brödtext som förklarar *varför* när det behövs) gör det möjligt att förstå hur och varför koden utvecklades, vilket är ovärderligt när man granskar historik, felsöker (förstår varför en ändring gjordes) eller introduceras för kodbasen.

Vaga meddelanden ("fixed stuff", "update", "wip") gör historiken oanvändbar, vilket gör det omöjligt att förstå ändringar senare — en verklig kostnad.

Konventionen **imperativ modus** ("Add feature" i stället för "Added feature") är en allmänt följd standard som är värd att känna till. **Bra commits är atomära och fokuserade** (varje commit är en logisk förändring, inte många orelaterade ändringar samlade tillsammans) är lika viktigt: fokuserade commits är mycket lättare att **granska** (granskare förstår en förändring), **återställa** (att ångra en förändring rent utan att påverka andra), förstå och **bisektera** (att hitta vilket commit som introducerade en bugg) — så commit-struktur påverkar direkt hur användbar historiken är för felsökning och samarbete.

Att kunna om **Conventional Commits** (standarden `type(scope): description` som möjliggör automatiserade ändringsloggar och versionshantering) är värdefullt eftersom det är mycket används.

Efftersom commit-historiken är viktig dokumentation och bra commits/meddelanden gör den läsbar och användbar (för att förstå, granska, felsöka och samarbeta) medan dåliga gör den oanvändbar, och eftersom att skapa fokuserade commits med tydliga meddelanden är kännetecknande för professionell Git-praxis, är förståelse för vad som gör commits och commit-meddelanden bra värdefullt, praktiskt relevant kunskap för effektivt samarbete och underhållbar historik — en skicklighet som särskiljer genomtänkta utvecklare och förbättrar ett projekts långsiktiga användbarhet och teamarbetsflöde meningsfullt.