Conventional Commits

Bir conventional commit mesajı bir tür, isteğe bağlı bir kapsam (scope) ve kısa bir açıklamayla başlar: feat(auth): add passkey login ya da fix: prevent double payment. En yaygın türler yeni özellikler için feat ve hata düzeltmeleri için fix'tir; kullanıcıları doğrudan etkilemeyen değişiklikler için de docs, refactor, test, perf, build, ci ve chore gibi başkaları vardır.

Kırıcı değişiklikler türden sonra bir ünlem işaretiyle, feat!: drop support for Node 18 örneğindeki gibi, ya da bir BREAKING CHANGE: alt satırıyla işaretlenir. Her türün bir anlamı olduğu için geçmiş doğrudan anlamsal sürümlemeye karşılık gelir: düzeltmeler bir patch sürümünü, özellikler bir minor sürümü, kırıcı değişiklikler de bir major sürümü tetikler.

2019'da yayımlanan 1.0.0 sürümlü şartname, Angular projesinin commit yönergelerinden doğdu. Araçlar onun üzerine kurulur: commitlint mesajları bir Git hook'unda ya da CI'da kontrol eder; semantic-release ya da release-please de geçmişi okuyarak sürümleri yükseltir, değişiklik günlüğünü yazar ve sürümleri elle iş yapmadan yayımlar.

Sık yapılan bir yanlış, bu kuralın yalnızca bürokrasi olduğunu düşünmektir. Tutarlı bir biçim geçmişi taramayı ve aramayı kolaylaştırır, ama en iyi commit'ler küçük ve odaklı olduğunda işe yarar. Bir özelliği, bir düzeltmeyi ve bir refactoring'i karıştıran tek bir commit dürüstçe tek bir türle etiketlenemez.