İyi bir commit ve commit mesajı ne yapar?

Question

Accepted Answer

İyi commit'ler **odaklanmış** (bir mantıksal değişiklik) ve neyin değiştiğini ve neden değiştiğini açıklayan **açık mesajlar** içerir. İyi yapılandırılmış commit'ler ve mesajlar proje geçmişini okunabilir yapar, değişiklikleri anlamak, hata ayıklamak ve işbirliği için faydalı hale getirir.

## İyi commit mesajları

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

## Emir kipi kuralı

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

## İyi commit'ler: atomik ve odaklanmış

```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 (popüler bir standart)

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

## Neden önemli

İyi commit'ler ve commit mesajlarının ne olduğunu anlamak **okunabilir, faydalı bir proje geçmişi oluşturmak** için değerlidir, bu nedenle işbirliği ve bakım yapılabilirliği önemli ölçüde etkileyen önemli pratik bilgidir. **İyi commit mesajları** önemlidir çünkü commit geçmişi önemli bir belgelendirme şeklidir — açık mesajlar (neyin değiştiğini açıklayan özlü bir özet, gerektiğinde neden değiştiğini açıklayan bir gövde) kodun nasıl ve neden evrimleştiğini anlamayı mümkün kılar, bu da geçmişi gözden geçirirken, hata ayıklarken (bir değişikliğin neden yapıldığını anlamak) veya yeni başlayanları onaylanırken çok değerlidir.

Belirli olmayan mesajlar ("birşeyler düzeltildi", "güncelle", "wip") geçmişi kullanışsız hale getirir, değişiklikleri daha sonra anlamayı imkansız kılar — gerçek bir maliyettir.

**Emir kipi kuralı** ("Özellik ekle" değil "Özellik eklendi") yaygın olarak takip edilen ve bilmeye değer bir standarttır. **İyi commit'lerin atomik ve odaklanmış olması** (her commit bir mantıksal değişiklik, birçok ilişkisiz değişiklik bir araya getirilmemiş) eşit derecede önemlidir: odaklanmış commit'ler çok daha kolay **gözden geçirilir** (gözden geçirenler bir değişikliği anlar), **geri alınır** (bir değişikliğin temiz bir şekilde geri alınması diğerlerini etkilemeden), anlaşılır ve **ikiye bölünür** (bir hatayı hangi commit'in tanıttığını bulma) — bu nedenle commit yapısı geçmişin hata ayıklama ve işbirliği için ne kadar kullanılabilir olduğunu doğrudan etkiler.

**Conventional Commits** hakkında bilgi sahibi olmak (`type(scope): description` standardı otomatik changelog ve versiyonlamayı etkinleştiren) değerlidir çünkü yaygın olarak benimsenir.

Commit geçmişi önemli belgelendirme olduğundan ve iyi commit'ler/mesajlar onu okunabilir ve faydalı (anlama, gözden geçirme, hata ayıklama ve işbirliği için) kılarken kötü olanlar onu kullanışsız hale getirdiğinden, ve odaklanmış commit'ler ve açık mesajlar yazmanın profesyonel Git uygulamasının bir işareti olduğundan, iyi commit'ler ve commit mesajlarının ne olduğunu anlamak etkili işbirliği ve bakım yapılabilir geçmiş için değerli, pratik olarak ilgili bilgidir — düşünceli geliştiricileri ayıran ve bir projenin uzun vadeli kullanılabilirliğini ve takım iş akışını anlamlı biçimde iyileştiren bir beceridir.