Changelog Nedir?
Yayın: · Son güncelleme:
Changelog Nedir? Kısaca
Changelog (değişiklik günlüğü), bir yazılımın her sürümünde nelerin eklendiğini, değiştiğini, düzeltildiğini ya da kaldırıldığını tarih sırasıyla listeleyen dosyadır. Kullanıcıların ve geliştiricilerin güncellemeden önce neyle karşılaşacağını görmesini sağlar.
Changelog nedir?
Changelog, Türkçede değişiklik günlüğü ya da sürüm notları olarak geçer. Genelde proje kökünde CHANGELOG.md adıyla durur. En yeni sürüm en üstte yer alır.
Kısa bir örnekle düşünelim: bir uygulamayı güncellemeden önce "bu sürümde ne değişti" diye merak ettiğinizde baktığınız yer burasıdır. Commit geçmişinden farklıdır. Commit'ler geliştiriciler için ayrıntılı kayıtlardır; changelog ise insanların okuyacağı, özetlenmiş ve anlamlı gruplara ayrılmış bir listedir.
İyi bir değişiklik günlüğü nasıl düzenlenir?
Yaygın bir yaklaşım, her sürümün altında değişiklikleri türlerine göre gruplamaktır. Örnek bir yapı:
## [2.3.0] - 2026-09-12
### Eklendi
- Faturaları PDF olarak indirme
### Düzeltildi
- Mobilde tarih seçicinin kapanmaması
Sürüm numarası ve tarih, kullanıcının hangi sürümde olduğunu anlamasını kolaylaştırır. "Eklendi, Değişti, Düzeltildi, Kaldırıldı" gibi başlıklar okumayı hızlandırır.
Kimin işine yarar?
İki farklı okur grubu vardır. Kullanıcı, güncellemenin kendisini etkileyip etkilemediğine bakar. Bir kütüphaneyi kullanan geliştirici ise geriye dönük uyumluluğu bozan değişiklikleri arar.
Örneğin bir muhasebe programının yeni sürümünde dışa aktarma biçimi değiştiyse, bunu changelog'da gören kullanıcı hazırlıklı olur. Bu yüzden bozucu değişiklikleri açıkça işaretleyin. Notları her release öncesi son anda değil, iş bittikçe eklemek de unutulan maddeleri azaltır.
Sıkça Sorulan Sorular
Changelog ile commit mesajları aynı şey mi?
Hayır. Commit mesajları teknik ve ayrıntılıdır, changelog ise kullanıcıya dönük ve özetlenmiştir. Onlarca commit, changelog'da tek bir madde olarak görünebilir.
Changelog otomatik oluşturulabilir mi?
Belirli bir commit mesajı standardı kullanan projelerde araçlar changelog taslağını otomatik çıkarabilir. Yine de okunabilirlik için bir insanın gözden geçirmesi faydalıdır.