Kas sudaro gerą commit'ą ir commit žinutę?

Question

Accepted Answer

Geri commit'ai yra **sukoncentruoti** (vienas loginis pakeitimas) su **aiškiomis žinutėmis**, kurios paaiškina, kas buvo pakeista ir kodėl. Gerai parengti commit'ai ir žinutės daro projekto istoriją skaitomą, naudingą keičiams suprasti, derinimui ir bendradarbiavimui.

## Geros commit žinutės

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

## Imperatyvo nuotaika – 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).
```

## Geri commit'ai: atominiai ir sukoncentruoti

```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 (populiarus standartas)

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

## Kodėl tai svarbu

Supratimas, kas sudaro gerus commit'us ir jų žinutės, yra vertingas kuriant **skaitomą, naudingą projekto istoriją**, todėl tai svarbi praktinė žinias, kuri reikšmingai veikia bendradarbiavimą ir priežiūrą. **Geros commit žinutės** yra svarbios, nes commit istorija yra labai svarbi dokumentacijos forma — aiškios žinutės (glausti santrauka, paaiškinanti *ką* buvo pakeista, o kai reikia ir tekstas, paaiškinantis *kodėl*) leidžia suprasti, kaip ir kodėl kodas evoliucionavo, o tai yra nepakeičiama žiūrint istoriją, derinant (suprasti, kodėl buvo padarytas pokytis) arba įsitraukiant į naują projektą.

Neaiškios žinutės („fixed stuff