Céard a dhéanann gealltanas maith agus teachtaireacht ghealltanais maith?

Question

Accepted Answer

Is iad na gealltanais maith ná cinn **dírithe** (athrú loighciúil amháin) le **teachtaireachtaí soiléire** a mhíníonn céard a athraíodh agus cén fáth. Fágann gealltanais agus teachtaireachtaí dea-dhéanta stair an tionscadail inléite, úsáideach chun tuiscint a fháil ar athruithe, díbhoghú, agus comhoibriú.

## Teachtaireachtaí gealltanais maith

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

## An gnás modh ordaitheach

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

## Gealltanais maith: adamhach agus dírithe

```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 (caighdeán coitianta)

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

## Cén fáth a bhíonn sé ábhartach

Tá sé luachmhar tuiscint a fháil ar céard a dhéanann gealltanais agus teachtaireachtaí gealltanais maith **chun stair an tionscadail inléite agus úsáideach a chruthú**, agus mar sin is eolas feidhmiúil tábhachtach atá ann a théann i bhfeidhm go mór ar chomhoibriú agus intuigtheacht. **Bíonn tábhacht ar theachtaireachtaí gealltanais maith** toisc gur foirm ríthábhachtach doiciméadúcháin a bhíonn sa stair ghealltanais — fágann teachtaireachtaí soiléire (achoimre gheal ag míniú *céard* a athraíodh, le corp ag míniú *cén fáth* nuair is gá) go mbíonn sé ina dhán tuiscint a fháil ar an dóigh ar évolve an cód agus cén fáth, atá neamhluachmhar nuair a bhíonn tú ag déanamh athbhreithniú ar stair, ag díbhoghú (tuiscint ar an fáth gur rinneadh an athrú), nó ag tabhairt isteach.

Is fúthu gan léargas iad teachtaireachtaí dorcha ("fixed stuff", "update", "wip") go stair gan úsáid, agus is leor dorcha go bhfuil sé ina dhoshéanta tuiscint a fháil ar athruithe níos déanaí — is costas fíor atá ann.

Is caighdeán coitianta a bhfuil an **gnás modh ordaitheach** ("Add feature" seachas "Added feature") toisc go bhíonn sé ina chóir an fhiafrainn a bhí ar eolas. **Is iad na gealltanais maith atá adamhach agus dírithe** (gealltanas amháin athrú loighciúil, ní go leor athruithe neamhghaolmhara le chéile) chomh tábhachtach: is lú fad a bhíonn gealltanais dírithe níos éasca a **athbhreithniú** (tuigeann na breathnóirí athrú amháin), **a thabhairt ar ais** (athrú amháin a chur ar ceal go geal gan cur i bhfeidhm ar dhream eile), tuiscint, agus **a bhisect** (ag fáil cé hé an gealltanas a thug isteach fabht) — agus mar sin bíonn tionchar díreach ag struchtúr an ghealltanais ar an dóigh ar bhí an stair inúsáidte do díbhoghú agus comhoibriú.

Tá sé luachmhar eolas a bheith agat maidir le **Conventional Commits** (an caighdeán `type(scope): description` a chumasaíonn cliste athraithe stailc agus leagaint) toisc go bhfuil sé i bhfad a ghlacadh.

De bharr go bhfuil stair ghealltanais ina doiciméadúchán tábhachtach agus fágann gealltanais agus teachtaireachtaí maith go mbíonn sé inléite agus úsáideach (chun tuiscint, athbhreithniú, díbhoghú, agus comhoibriú) agus fágann cinn dona go mbíonn sé gan úsáid, agus de bharr gur iad an cruthú gealltanais dírithe le teachtaireachtaí soiléire atá ina saintréithe an cleachtas Git gairmiúil, tá sé ina eolas feidhmiúil, réamhtheolaithe luachmhar a thuigfidh na feidhmchláir éifeachtúil agus stair intuigthe — scil nach cuid de bhreithniú forbhuiste agus a bhagairt ar a dhéanfaidh tionscadal fé dhéara ar fad go fadtéarmach agus sreabh obair an fhoireann — is eolas feidhmiúil, réamhtheolaithe luachmhar atá ann chun comhoibriú éifeachtúil agus stair intuigthe a bhaint amach — scil nach cuid de bhreithniú forbhuiste agus a bhagairt ar a dhéanfaidh tionscadal fé dhéara ar fad go fadtéarmach agus sreabh obair an fhoireann.