Changelog ve Sürüm Notu Nasıl Yazılır? (Klişesiz Rehber)

"Hata düzeltmeleri ve performans iyileştirmeleri."

Bu cümle, yazılım dünyasının en çok kopyalanan ve en boş metnidir. Kullanıcıya sıfır bilgi verir; tek mesajı şudur: "Sana ne değiştiğimizi anlatacak kadar değer vermiyoruz."

Oysa sürüm notu, ürünün en düzenli iletişim kanalıdır; doğru kullanıldığında da sessiz bir pazarlama motorudur.

Sürüm notu kimin için, ne işe yarar?

Üç okuyucusu vardır:

1. Aktif kullanıcı: "Benim işimi etkileyen ne değişti?" Özellikle davranış değişiklikleri ve düzeltilen hatalar.
2. Karar aşamasındaki kişi: Mağaza/ürün sayfasında güncelleme geçmişine bakan potansiyel kullanıcı. Düzenli, anlamlı notlar = "yaşayan ürün" sinyali.
3. Ekibin kendisi: Ne zaman neyi değiştirdiğinizin kaydı: destek, hata ayıklama ve "bu ne zaman değişmişti?" soruları için.

Yazım kuralları

Özellik değil, fayda dili: "Toplu dışa aktarma eklendi" yerine → "Artık 50 dosyayı tek seferde dışa aktarabilirsiniz, tek tek indirme dönemi bitti."

Kullanıcının kelimeleriyle: İç jargon ("refactor", "modül optimizasyonu") dışarıda anlamsızdır. Değişikliği, kullanıcının yaşadığı hâliyle anlatın: "Büyük projeler artık daha hızlı açılıyor."

Düzeltmelerde dürüstlük: Bilinen bir hatayı düzelttiyseniz adını koyun: "Bazı kullanıcılarda kaydetme sırasında yaşanan donma sorunu giderildi." Bunu yaşayan kullanıcı için bu satır, "beni duydular" demektir; sadakatin hammaddesi de budur.

Teşekkür kültürü: Geri bildirimden doğan değişikliklerde söyleyin: "Bu iyileştirme, sizden gelen istekler üzerine geldi." Geri bildirim veren kullanıcı, sonucunu gördüğünde vermeye devam eder.

Pratik format şablonu

Uzun listeler okunmaz; üç kova yeter:

✨ Yeni

• [Fayda cümlesiyle en önemli 1-3 yenilik]

🔧 İyileştirildi

• [Fark edilir iyileştirmeler, kullanıcı diliyle]

🐛 Düzeltildi

• [Bilinen/bildirilen hatalar, açık adlarıyla]

Büyük sürümlerde tek satır özet ekleyin: "Bu sürümün özeti: dışa aktarma baştan yazıldı." Kullanıcı detaya inmeden ana mesajı alsın.

"Anlatacak bir şey yok" sürümleri

Gerçekten sadece iç temizlik yapılan sürümler olur. İki dürüst seçenek:

1. Kısa ve gerçek: "Bu sürüm tamamen sahne arkası: gelecek özellikler için altyapı hazırlığı."
2. Bağlam ekleyin: "Görünür yenilik yok; ama önümüzdeki sürümdeki büyük yenilik için zemin döşedik."

İkisi de "hata düzeltmeleri ve iyileştirmeler" klişesinden iyidir; çünkü ikisi de bir insan tarafından yazılmıştır.

Sık sorulan sorular

Her sürümde not şart mı? Kullanıcıya dokunan her sürümde evet. Günde beş kez sessiz dağıtım yapan ekipler için: haftalık toplu "neler değişti" özeti, sürüm başına nottan iyi çalışır.

Sürüm notu nerede yayınlanmalı? Değişikliğin görüleceği her yerde: mağaza notu, uygulama içi "yenilikler" ekranı ve (varsa) web'de changelog sayfası. Web sayfası ayrıca SEO'ya ve "canlı ürün" algısına sessizce çalışır.

Mizah kullanılır mı? Marka tonunuz taşıyorsa, dozunda; ama asla bilginin yerine değil. Esprili ama boş not, klişe notun makyajlı hâlidir.

---

Bu rehber, kendi ürün sürümlerimi duyurma pratiğimden derlenmiştir.