Was macht einen guten Commit und eine gute Commit-Nachricht aus?

Question

Accepted Answer

Gute Commits sind **fokussiert** (eine logische Änderung) mit **klaren Nachrichten**, die erklären, was sich geändert hat und warum. Gut gestaltete Commits und Nachrichten machen die Projekt-Historie lesbar und nützlich zum Verständnis von Änderungen, zum Debuggen und für die Zusammenarbeit.

## Gute Commit-Nachrichten

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

## Die Imperativ-Mood-Konvention

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

## Gute Commits: atomar und fokussiert

```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 (ein beliebter 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.
```

## Warum es wichtig ist

Zu verstehen, was gute Commits und Commit-Nachrichten ausmacht, ist wertvoll für **die Erstellung einer lesbaren und nützlichen Projekt-Historie**, daher ist es wichtiges praktisches Wissen, das die Zusammenarbeit und Wartbarkeit erheblich beeinflusst. **Gute Commit-Nachrichten** sind wichtig, weil die Commit-Historie eine entscheidende Form der Dokumentation ist — klare Nachrichten (eine prägnante Zusammenfassung, die erklärt, *was* sich geändert hat, mit einem Body, der erklärt, *warum*, wenn nötig) ermöglichen es, zu verstehen, wie und warum sich der Code entwickelt hat, was unbezahlbar ist, wenn man die Historie überprüft, debuggt (versteht, warum eine Änderung gemacht wurde) oder neue Entwickler einarbeitet.

Vage Nachrichten ("fixed stuff", "update", "wip") machen die Historie nutzlos und machen es unmöglich, Änderungen später zu verstehen — ein echter Nachteil.

Die **Imperativ-Mood-Konvention** ("Add feature" statt "Added feature") ist ein weit verbreiteter Standard, den es lohnt sich zu kennen. **Gute Commits sind atomar und fokussiert** (jeder Commit eine logische Änderung, nicht mehrere unabhängige Änderungen zusammengefasst) ist gleich wichtig: fokussierte Commits sind viel leichter zu **überprüfen** (Reviewer verstehen eine Änderung), **rückgängig zu machen** (das Rückgängigmachen einer Änderung ohne Auswirkungen auf andere), zu verstehen und zum **Bisect** (Finden heraus, welcher Commit einen Fehler eingeführt hat) — daher beeinflsst die Commit-Struktur direkt, wie nutzbar die Historie für Debugging und Zusammenarbeit ist.

Wissen über **Conventional Commits** (der `type(scope): description` Standard, der automatisierte Changelogs und Versionierung ermöglicht) ist wertvoll, da er weit verbreitet ist.

Da die Commit-Historie wichtige Dokumentation ist und gute Commits/Nachrichten sie lesbar und nützlich machen (zum Verständnis, zur Überprüfung, zum Debuggen und für die Zusammenarbeit), während schlechte sie nutzlos machen, und da die Erstellung fokussierter Commits mit klaren Nachrichten ein Kennzeichen professioneller Git-Praxis ist, ist das Verständnis, was gute Commits und Commit-Nachrichten ausmacht, wertvoll und praktisch relevantes Wissen für effektive Zusammenarbeit und wartbare Historie — eine Fähigkeit, die nachdenkliche Entwickler auszeichnet und den langfristigen Nutzen und Workflow eines Projekts erheblich verbessert.