Changelog yazma, yazılım projelerinde sürümler arası değişiklikleri sistematik biçimde kayıt altına alma sürecidir. Bakımsız veya yanlış biçimlendirilmiş bir changelog hem geliştirici deneyimini hem kullanıcı güvenini zedeler. **Adım 1: Keep a Changelog Formatını Benimseyin** Endüstri standardı olarak kabul gören bu format şu kategorileri kullanır: - Added: Yeni özellikler - Changed: Mevcut özelliklerdeki değişiklikler - Deprecated: Yakında kaldırılacak özellikler - Removed: Kaldırılan özellikler - Fixed: Hata düzeltmeleri - Security: Güvenlik yamaları **Adım 2: Sürüm Numarası ve Tarihi Ekleyin** Her sürüm başlığı versiyon numarası ve yayınlanma tarihini içermeli: `## [2.1.0] - 2026-05-10`. Changelog yazma sürecinde tarih formatı ISO 8601 (YYYY-MM-DD) olmalı. **Adım 3: Değişiklikleri Kullanıcı Perspektifinden Yazın** Teknik commit mesajını değil, kullanıcıyı etkileyen değişikliği yazın. "fix: null pointer exception" yerine "Boş profil fotoğrafı olan hesaplarda çökme sorunu giderildi." **Adım 4: Kırıcı Değişiklikleri (Breaking Changes) Vurgulayın** API değişiklikleri, silinmiş parametreler veya format değişiklikleri açıkça işaretlenmeli. Changelog yazma disiplininde bu bölüm en kritiktir; kullanıcılar yükseltme öncesinde bunu okur. **Adım 5: Yayınlanmamış Değişiklikler Bölümü Tutun** Aktif geliştirme sürecinde yapılan değişiklikler `[Unreleased]` başlığı altında tutulur. Sürüm yayınlanınca bu bölüm versiyona taşınır. **Adım 6: Changelog'u Kod Reposunda Tutun** CHANGELOG.md dosyası projenin kök dizininde yer almalı ve kod reposuyla birlikte versiyonlanmalı. Harici araçlara bağımlılıktan kaçının. **Adım 7: Otomasyonu Değerlendirin** Conventional Commits standardını izleyen ekipler için changelog yazma süreci otomatize edilebilir; ancak çıktı her zaman insan gözünden geçirilmelidir.