Ce face un commit și un mesaj de commit bun?

Question

Accepted Answer

Commiturile bune sunt **focalizate** (o singură schimbare logică) cu **mesaje clare** care explică ce s-a schimbat și de ce. Commiturile și mesajele bine elaborate fac istoricul proiectului lizibil, util pentru înțelegerea schimbărilor, debugging și colaborare.

## Mesaje bune de commit

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

## Convenția modului imperativ

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

## Commituri bune: atomice și focalizate

```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 (un standard popular)

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

## De ce conteaza

Înțelegerea a ceea ce face commiturile și mesajele de commit bune este valoroasă pentru **crearea unui istoric de proiect lizibil și util**, deci este cunoștință practică importantă care afectează semnificativ colaborarea și capacitatea de manutenție. **Mesajele bune de commit** conteaza pentru că istoricul commit-ului este o formă crucială de documentație — mesajele clare (un rezumat concis care explică *ce* s-a schimbat, cu un corp care explică *de ce* când este necesar) fac posibil să înțelegeți cum și de ce codul a evoluat, ceea ce este neprețuit atunci când revizuiți istoricul, debugging-ul (înțelegând de ce a fost făcută o schimbare) sau onboarding-ul.

Mesajele vagi ("fixed stuff", "update", "wip") fac istoricul inutil, imposibil de înțeles schimbările mai târziu — un cost real.

Convenția **modului imperativ** ("Add feature" nu "Added feature") este un standard urmat pe scară largă pe care merită să-l cunoașteți. **Commiturile bune fiind atomice și focalizate** (fiecare commit o singură schimbare logică, nu mai multe schimbări neînrudite lipite împreună) este la fel de important: commiturile focalizate sunt mult mai ușor de **revizuit** (revizorii înțeleg o singură schimbare), **revert** (anularea unei schimbări curate fără a afecta altele), înțeles și **bisect** (găsind care commit a introdus un bug) — deci structura commit-ului afectează direct cât de utilizabil este istoricul pentru debugging și colaborare.

Cunoașterea despre **Conventional Commits** (standardul `type(scope): description` care permite changelog-uri și versionate automate) este valoroasă deoarece este adoptat pe scară largă.

Deoarece istoricul commit-ului este documentație importantă și commiturile/mesajele bune o fac lizibilă și utilă (pentru înțelegere, revizuire, debugging și colaborare) în timp ce cele proaste o fac inutilă, și deoarece elaborarea de commituri focalizate cu mesaje clare este o caracteristică a practicii Git profesionale, înțelegerea a ceea ce face commiturile și mesajele de commit bune este cunoștință valoroasă și practică pentru colaborare eficientă și istoric ușor de menținut — o abilitate care deosebește dezvoltatorii gânditori și îmbunătățește semnificativ utilizabilitatea pe termen lung a unui proiect și fluxul de lucru al echipei.