Bir Kaydı Birinin Eylem Yapabileceği Bir Rapora Dönüştürün
Hatanın ekran kaydını yükleyin. Oynatın ve önemli bir şey her olduğunda işaretleyin. Zaman damgası yakalanır, videodan o anda bir kare alınır ve adım numaralı bir listeye eklenir.
Özeti, ne beklediğinizi ve bunun yerine ne olduğunu yazın, ardından tümünü GitHub için Markdown, Jira biçimlendirmesi veya düz metin olarak kopyalayın. Tarayıcı ve ekran detayları zaten doldurulmuştur.
Kayıt hiçbir zaman makinenizden ayrılmaz. Yerel bir dosyadan oynatılır ve kareler cihazınızda çizilir, bu da hatanın yayınlanmamış bir yapıda veya bir müşterinin hesabında olması durumunda önemlidir.
Neden Bu, Raporu Yazmak İçin Yapay Zeka Kullanmıyor
Bir ekran kaydını izleyen bir model, gördüklerini açıklayabilir. Ne görmeyi beklediğinizi bilemez ve bu, bir hata raporunun üzerinde birinin eylem yapıp yapmayacağına karar veren yarısıdır.
“Onayla’ya tıkladı, fatura paneli boştu” bir gözlemdir. Bunun bir hata olup olmadığı tamamen orada neyin görünmesi gerektiğine bağlıdır ve bunu bilen tek kişi sizsiniz. Bir videodan beklenen davranışı oluşturan bir araç tahmin yürütüyor ve tahmini bir bulgu olarak sunuyor, bu da alanı boş bırakmaktan daha kötü, çünkü makul ama yanlış bir beklenti bir geliştiriciyi yanlış yola sokar.
Yani buradaki ayrım kasıtlıdır. Araç yapabileceği mekanik işi tam olarak yapar: zaman damgaları, kareler, ortam, biçimlendirme, numaralandırma. Kararı siz verirsiniz. Bu yaklaşık bir dakika sürer ve sonuç olarak kimsenin size geri dönmek zorunda kalmadığı bir rapor ortaya çıkar.
Raporların Genellikle Gözden Kaçırdığı Üç Şey
Çok sayıda zayıf hata raporu okuduktan sonra, aynı boşluklar tekrar ortaya çıkıyor ve üçü de zor olmaktan ziyade mekanik.
Zaman damgaları. “Ekteki videoya bakın” diyen bir rapor, okuyucuyu o anı bulmak için dört dakika izletir. 1:12’de olduğunu söyleyen bir adım bunu yapmaz.
Ortam. Tarayıcı, işletim sistemi, ekran boyutu. Herkes bunu dahil etmeyi bilir ve neredeyse hiç kimse yapmaz, çünkü bu, düşüncenizin ortasındayken bir ayarlar panelini açmak anlamına gelir. Burada tarayıcınızdan okunur ve raporda zaten doldurulmuş olarak bulunur, siz de düzeltebilirsiniz.
Hareketsiz görüntüler. Yirmi maddelik bir listede taranan şey, hatanın anındaki bir karedir. Bir videodan kareleri elle çıkarmak o kadar sıkıcıdır ki insanlar bunu atlar, bu yüzden işaretlediğiniz her adımda otomatik olarak gerçekleşir.
Tam Olarak Ne Yakalanır
İşaretlenen her adım, tam oynatma süresini ve o zamanki videodan bir JPEG karesini kaydeder, raporu hafif tutmak için küçültülür. Kareleri indirip soruna ekleyebilirsiniz.
Ortam tarayıcıdan gelir: adı ve sürümü, işletim sistemi, piksel oranıyla ekran boyutu ve görüntü alanı boyutu. Tarayıcılar artık eskisi kadar kendileri hakkında bilgi rapor etmiyor, bu yüzden bazıları bilinmeyen olarak gelebilir ve her alan kilitli olmaktan ziyade düzenlenebilirdir.
Piksellerden hiçbir şey çıkarılmaz. Araç, ekrandan hata metnini okumaya veya hangi öğeye tıkladığınızı tahmin etmeye çalışmaz, çünkü bunu güvenilmez bir şekilde yapmak, hiç yapmamaktan daha kötüdür.
Doldurduğu Yapı
Çıktı, bir hata raporunun oturduğu şekli takip eder, çünkü takip sistemleri ve onları okuyan kişiler bunu bekler. Bir hata raporu şablonu arıyorsanız, bu yapıştırıp bakacağınız bir şablon yerine zaten doldurulmuş olarak gelen bir şablondur.
Önce özet, tek bir satırda, çünkü bu satır otuz maddelik bir listede birinin taradığı şeydir ve sizinkinin bugün açılıp açılmayacağına karar verir.
Sonra her birinde zaman kodu bulunan numaralı adımlar, beklenen davranış, gerçekleşen davranış ve ortam. Bu sıra bir süsleme değildir. Bir okuyucu, tekrarlanabilir olup olmadığını görmek için adımları, gerçekten bir hata olup olmadığını görmek için beklenen ve gerçekleşen çiftini ve kendilerine ait olup olmadığını görmek için ortamı kontrol eder. Bunlardan herhangi birini gömmek bir gidiş-dönüş maliyeti getirir.
Boş bir şablonun yapamayacağı şey, kendini doldurmaktır, ki bu da insanların onu atlamasına neden olan kısımdır. Burada adımlar, zaman kodları, kareler ve ortam dolu olarak gelir ve bir aracın gerçekten bilemeyeceği üç alanı siz yazarsınız.
Kayda Başlamadan Önce
Rapor, kaydın kalitesi kadardır ve iki alışkanlık fark yaratır.
Bilinen bir durumdan başlayın. Oturumun ortasında başlayan bir kayıt, okuyucunun öncesinde ne olduğunu tahmin etmesine neden olur, bu nedenle adımlar tekrarlanabilir olmaktan çıkar. Bir giriş ekranından, yeni bir sayfadan veya tanımlanmış bir başlangıç noktasından başlayın.
Ekranda taşınmaması gereken her şeyi temizleyin. Bir URL çubuğundaki token’lar, bir müşterinin adı, başka bir sekmedeki alakasız bir e-posta, bir geliştirici araçları panelindeki bir API anahtarı. Bir hata raporu iletilir, sohbete yapıştırılır ve ekip dışındaki kişiler tarafından okunur ve bir ekran kaydı o sırada ekranda olan her şeyi taşır. Bu araç videoyu asla yüklemez, ancak rapor ve kareler siz nereye gönderirseniz oraya gider.
Yapmadığı Şeyler
Sorunu kaydetmez. GitHub, Jira veya başka herhangi bir şeye bağlantısı yoktur; raporu kopyalar ve ait olduğu yere yapıştırırsınız, bu da başkalarından önce okuma fırsatınız olduğu anlamına gelir.
Günlükleri, ağ isteklerini veya konsol çıktılarını yakalamaz. Bunlar geliştirici araçlarınızda bulunur ve bazı hatalar için son derece önemlidir. Bir konsolu filme almak yerine, ekibinizin zaten kullandığı güvenli yolla ekleyin.
Ve hiçbir şeyi teşhis etmez. Size nedeni, hangi bileşenin hatalı olduğunu veya bunun mevcut bir sorunu kopyalayıp kopyalamadığını söylemez. Kanıtı birinin üzerinde çalışabileceği bir şekle getirir ve işin tamamı budur.
Hatayı Kaydetmek
Sorunu hala yakalamanız gerekiyorsa, ekran kaydedici tarayıcıda bir sekme, bir pencere veya tüm ekranı kaydeder. Yeniden oluştururken anlatmanız gereken bir hata için sesli kayıt yapın ve açıklama kanıta ekli kalsın.
Bilinmeye değer iki yardımcı araç. Rapor yerine tek tek görüntüler istiyorsanız, video kare çıkarıcı kareleri belirli aralıklarla çeker. Ve eğer kayıt uzunsa ve sözlü anlatımı metin olarak istiyorsanız, transkript oluşturucu anlatımı aranabilir bir şeye dönüştürür.
