Changelog Yazmayı Unutmak

Kayıt listesinin sıralamasını değiştirdim. Bana göre düzeldi. İki kişi eski sırayı aradı, 'arama bozuldu' dedi. Arama aynıydı; dünya kaymıştı. Not yoktu. Not olmayınca her fark bir regresyon.

Kime yazılıyor

Changelog yeni gelen için değil. Yeni gelen zaten yeni dünyayı görür. Yazı, dün gelen içindir: ne değişti, senin işin nasıl kayar, geri alma var mı. 'Performans iyileştirmeleri' cümlesi bu sorulara cevap değil. O cümleyi yazmayı bıraktım.

Biçim kısa. Tarih. Bir cümle davranış. Bir cümle neden — gerekirse. Ekran görüntüsü yok, slayt yok. Commit mesajını olduğu gibi yapıştırmıyorum; commit geliştiriciye, changelog kullanıcının işine konuşur.

Ne zaman zorunlu

Sıra, kısayol, dışa aktarma alanı, fiyat sınırı, silinen bir düğme. Bunlar not ister. Renk tonu, iç log, kimsenin görmediği bir sorgu — istemez. Ayırt etmek için destek kutusuna bakıyorum: bu fark bir mail üretir mi? Üretirse yaz.

Unutmak, yazmamak değil yalnızca. Unutmak, mevcut kullanıcıyı her seferinde yeniden onboarding'e sokmak. Onboarding yazısında yeni geleni boş bırakmıştım. Changelog, o hatanın eski kullanıcıya yapılan hali.