Stüdyo kültürü ve yaratıcı süreç / DIJION
“Çalışmıyor”dan tekrar üretilebilir mobil hata raporuna
Başlangıç durumu, adımlar ve beklenen sonucu ayıran; kesinti, cihaz ve veri bağlamıyla araştırılabilir hata raporu hazırlama planı.
“Kaydet çalışmıyor” mesajı önemli bir sorunu işaret edebilir ama geliştiricinin aynı duruma ulaşmasını sağlamaz. Örnek bir not uygulamasında sorun yalnız çevrimdışı düzenlenen eski taslakta ortaya çıkabilir. İyi rapor, kullanıcının şikâyetini teknik terimlere boğmadan başlangıç koşulu, davranış ve etkisiyle araştırılabilir bir duruma dönüştürür.
Başlangıç koşulunu adımlardan önce yazın
Hesap türü, kayıt durumu, bağlantı ve uygulama sürümü sonucu değiştirebilir. “Uygulamayı aç” adımı tek başına yeterli olmayabilir; uygulama daha önce açık mıydı, süreç yeniden mi başladı? Gerekli veriyi yapay bir örnekle tarif edin. Parola, oturum anahtarı veya gerçek özel belgeyi rapora koymak tekrar üretimin şartı olmamalıdır.
Beklenen ile görüleni ayrı tutun
Tüm sütunlar için tabloyu yatay kaydırabilirsiniz.
| Alan | Yararlı ifade | Kaçınılacak ifade |
|---|---|---|
| Adım | Çevrimdışıyken başlığı değiştir ve Kaydet seç | Biraz kurcala |
| Beklenen | Taslak korunur ve durum açıklanır | Düzgün çalışmalı |
| Görülen | Metin silindi, hata görünmedi | Bence veri tabanı bozuk |
Kanıtı soruyla eşleştirin
Kısa ekran kaydı adım sırasını, ekran görüntüsü görünür sonucu gösterebilir. Kayıtta bildirim veya kişisel bilgi varsa paylaşmadan temizleyin. Günlük çıktısı yalnız ilgili zaman ve güvenli alanları içersin. Tekrar sıklığını yazın ama denemediğiniz cihazları etkileniyor gibi işaretlemeyin; doğrulanan ortam ile olası kapsam ayrı kalmalıdır.
Belirtiyi kök neden gibi yazmayın
Sorunu sadeleştirirken hangi koşulu kaldırdığınızı not edin. Ağ kesilince olmaması ağın kesin neden olduğunu göstermez; zamanlama da değişmiş olabilir. Birden çok belirti varsa aynı kayıt altında mı araştırılacağını gerekçelendirin. Raporun başlığı kullanıcı etkisini anlatsın; çözüm tahmini araştırma notunda ayrı bulunsun.
Raporu başka biriyle yürütün
- Ön bilgisi olmayan biri aynı başlangıç durumunu kurabilsin.
- Adımlar sıra ve eylem bakımından açık olsun.
- Beklenen, görülen ve yardım gereksinimi ayrı yazılsın.
- Düzeltme aynı senaryo ve komşu akışla kontrol edilsin.
Sonuç daha uzun bir bilet değil, daha az varsayım isteyen bir rapordur. Tekrar üretilemiyorsa da gözlenen kanıtı koruyun ve eksik bağlamı açıkça işaretleyin.