Sürüm notları neden bu kadar sık belirsiz veya yanlış olur?
Sürüm notları, son dakikada, tüm görüşmelere katılmamış biri tarafından, kimsenin tanımlamadığı bir kitle için iş kayıtlarının başlıklarından yazıldığı için amacına ulaşamaz. Sonuç, ya kurum içi jargonla dolu bir liste ya da sunulandan fazlasını vadeden neşeli bir özet olur.
Fitness stüdyoları için rezervasyon aracı geliştiren, 15 kişilik hayali bir yazılım şirketi olan Tallyhop'u düşünün. Ürün yöneticisi Dev'in elinde 4.3 sürümüne dahil edilmiş şu iş kayıtları var: 'TH-412 yaz saati geçişlerinde tekrarlayan derslerde saat dilimi hatasını düzelt. TH-398 bekleme listesinden otomatik kayıt (waitlist_v2 bayrağı, 20% kullanıma açma). TH-405 ödeme hizmetini yeni SDK'ya göre yeniden yapılandır. TH-410 gezinme menüsünde Üyeler adını Müşteriler olarak değiştir. TH-401 CSV dışa aktarma v1 kullanımını sonlandır, 1 Aralık'ta kaldırılacak. TH-415 takvim yükleme performansı.'
Bu sürüm hakkında üç farklı grubun bilgilendirilmesi gerekiyor. Stüdyo sahipleri bekleme listesiyle, adı değiştirilen menüyle ve dışa aktarma özelliğinin kaldırılmasıyla ilgilenir. Destek ekibinin, bekleme listesinin kimlere açık olduğunu ve Üyeler bölümünü bulamayanlara ne söyleyeceğini bilmesi gerekir. Dışa aktarma özelliğini kullanan geliştiricilerin ise kesin tarihi ve yerine kullanılacak çözümü bilmesi gerekir.
Sürüm notları adım adım nasıl yazılır?
Sürüm notlarını yazarken önce nelerin kimlere sunulduğunu doğrula, ardından değişiklikleri sabit kategorilere ayır ve her hedef kitle için ayrı bir sürüm hazırla. Her sürümde önce okuyucu üzerindeki etkiyi ve yapması gerekenleri belirt. Yapay zeka sınıflandırmayı ve yeniden ifade etmeyi iyi yapar; kayıt başlıklarından göremeyeceği gerçekleri sen sağlarsın.
1. Kullanıma sunulanları doğrulayın
Her iş kaydını yayınlanan sürümle karşılaştırın: birleştirilmiş ama özellik bayrağı arkasında mı, kısmen mi kullanıma açılmış, yoksa tamamen yayında mı? %20 oranında kullanıma sunulmuş olması, 'artık kullanılabilir' olduğu anlamına gelmez.
2. Kategorilere ayırın
Yeni, iyileştirilen, düzeltilen, değiştirilen, kullanımdan kaldırılması önerilen veya kaldırılan özellikler ve bilinen sorunlar. Okuyucular kendilerini etkileyen kategoriyi bulmak için metni tarar.
3. Her hedef kitlenin ne göreceğine karar verin
Müşteriler, iç yapıdaki kod düzenlemeleriyle nadiren ilgilenir. Destek ekibinin kullanıma sunma ayrıntılarına ihtiyacı vardır. Geliştiriciler ise tarihleri, sürümleri ve kaldırılanların yerine ne kullanılacağını bilmek ister.
4. Önce etkiyi belirtin
'Tekrarlanan dersler artık saatler ileri veya geri alındığında doğru saatte kalıyor' ifadesi, 'Saat dilimi hatası düzeltildi' ifadesinden daha iyidir.
5. Yapılacak işleri ve tarihleri açıkça belirtin
Okurun yapması gerekenler ve bunları ne zamana kadar yapması gerektiği, en başta ve ayrı bir satırda belirtilir.
6. Sürümü tutarlı biçimde numaralandırın
Anlamsal sürümleme kullanıyorsanız ilk sayı uyumsuz değişiklikleri, ikinci sayı geriye dönük uyumlu özellikleri, üçüncü sayı ise geriye dönük uyumlu düzeltmeleri belirtir. Böylece okuyanlar riski bir bakışta değerlendirebilir.
Yetersiz ve iyileştirilmiş bir yapay zeka sürüm notu nasıl olur?
Zayıf istem: 'Bu kayıtlardan sürüm notları yaz.' Tipik sonuç: '4.3 sürümü iyileştirmelerle dolu! Bekleme listeleri artık herkes için müşterileri otomatik olarak sıradan alıyor. Daha hızlı ve daha güvenli ödeme için ödemeleri yeniden oluşturduk. Üyeler artık Müşteriler oldu. Takvim daha hızlı yükleniyor.' Üç sorun var: bekleme listesi yalnızca bazı stüdyolarda kullanılabiliyor, ödeme kodunun yeniden düzenlenmesi hız veya güvenlik konusunda hiçbir vaat içermiyordu ve işlem yapılmasını gerektiren tek değişiklik olan CSV dışa aktarmanın kaldırılması belirtilmemiş.
İyileştirilmiş istem: 'Aşağıdaki kayıtlardan stüdyo sahiplerine yönelik sürüm notları yaz. Kategoriler: yeni, iyileştirilen, düzeltilen, kaldırılan. Yalnızca stüdyo sahiplerinin görebileceği değişiklikleri ekle. TH-398 yalnızca bazı stüdyolarda kullanılabiliyor; bu yüzden kademeli olarak kullanıma sunulduğunu belirt. TH-405 kurum içi bir değişiklik; bunu ekleme. CSV dışa aktarma özelliğinin kaldırılmasını, tarihi ve yerine ne kullanılacağıyla birlikte en başa yaz: [alternatif]. Kayıtta belirtilmeyen faydalardan söz etme. Sade bir dil kullan ve kayıt numaralarını yazma.'
İyileştirilmiş sonuç şu ifadeyle başlar: 'İşlem gerekiyor: mevcut CSV dışa aktarma özelliği 1 Aralık tarihinde kaldırılacak. Bunun yerine [alternatif] kullanın.' Ardından bekleme listesinden otomatik geçiş özelliğinin kademeli olarak kullanıma sunulduğunu belirtir, Müşteriler adının değiştirilmesini tek satırda açıklar ve yaz saati düzeltmesini ders saatleri üzerinden anlatır. İkinci bir istem, özellik bayrağının adını ve kullanıma açılma yüzdesini içeren destek sürümünü; üçüncü bir istem ise geliştiriciler için kısa bir değişiklik günlüğünü oluşturur.
Sürüm notlarının doğruluğunu nasıl kontrol edersiniz?
Sürüm notlarını kontrol ederken her cümlenin dayandığı iş kaydını bulun ve kullanılabilirlik, tarihler veya işleyişle ilgili her bilgiyi mühendise ya da ürün sorumlusuna doğrulatın. Sürüm notu, müşterilere verilen bir sözdür; kontrol edilmemiş bir satır, destek talebine dönüşür.
Kullanılabilirlik
Her özellik herkesin kullanımına mı açık, yalnızca bir gruba mı açık, yoksa henüz kimseye açılmadı mı? İfadeleri kullanıma sunulma durumuna göre seçin.
Uydurulmuş faydalar
Birisi bunları ölçmediyse veya bunlara karar vermediyse 'daha hızlı', 'daha güvenli' ya da 'daha kolay' gibi ifadeleri silin.
Eylemler ve tarihler
Kaldırma tarihlerini ve yerine gelecek seçenekleri sorumlu kişiyle teyit edin; okuyucularınızın kullandığı tarih biçimini kontrol edin.
Ekrandaki adlar
Özellik ve menü adları, özellikle bir ad değişikliğinden sonra, üründekilerle birebir aynı olmalıdır.
Yapay zekayla sürüm notları hazırlarken sık yapılan hatalar nelerdir?
En yaygın hata, herkese tek bir sürüm yayımlamaktır; bu, müşterilerin yapması gerekenleri ayrıntılar arasında kaybederken ihtiyaç duymadıkları kurum içi bilgileri açığa çıkarır. Diğer hatalar: özellik bayrağıyla kontrol edilen özellikleri kullanıma açılmış gibi duyurmak, aracın pazarlama iddiaları eklemesine izin vermek, kaldırılan bir özelliği 'iyileştirmeler' altında gizlemek, müşteri notlarında destek talebi kodlarını bırakmak ve henüz yayımlanmamış yol haritası maddelerini veya güvenlik düzeltmelerinin ayrıntılarını herkese açık bir araca yapıştırmak. Özellikle güvenlik düzeltmeleri, herhangi bir yerde paylaşılmadan önce ekibinizin açıklama kurallarına uygun biçimde ele alınmalıdır.
Bu dersin Tosheo.ai kataloğundaki yeri nedir?
Sürüm notları, Ürün için yapay zeka kategorisinde yer alan Uygulayıcı düzeyinde bir derstir; görüşme sentezi, gereksinim belgeleri ve kullanıcı hikayeleri, geri bildirim analizi, rakip araştırması ve önceliklendirme ödünleşimleri dersleriyle aynı kategoridedir. Tam liste, ürün ekipleri için yapay zeka eğitimi sayfasındadır. Uygulamalı görevde size kurgusal bir iş kaydı listesi verilir ve iki farklı kitle için iki sürüm yazarsınız; puanlama kılavuzu, kullanıma sunulma durumunu belirten ifadeleri, yapılacak işlemleri, uydurulmuş iddiaları ve hedef kitleye uygunluğu kontrol eder.