Ana içeriğe geç

Hata Raporu Gereksinimleri

Bir hata raporunu nasıl düzgün bir şekilde belgelerim ve Test IO'nun standartları nelerdir?

Yazar: Nikola Jonic

Bu makalede, hatanı kurallarımıza ve standartlarımıza uygun bir şekilde nasıl düzgün bir şekilde belgeleyeceğini öğreneceksin. Müşterilerin bir hatayı anlayabilmesi için yeterli bilgiye ve kaliteli belgelere ihtiyaçları var. Bu yazının her bölümünde kurallarımızla ilgili daha detaylı bilgiler bulacaksın, ancak işte hata raporu gereksinimlerinin hızlı bir özeti:

  • Eğer işlevsel bir hata bildiriyorsan, hata raporunun geri kalanını doldurmadan önce uygun olan Şiddet seviyelerinden birini seçmen gerekiyor.

  • Başlık, hatayı özetlemeli ve hata raporunu açmadan sorunun anlaşılması için gerekli bilgileri içermelidir. Gerekli bilgiler; ne olduğu, hatanın nerede meydana geldiği ve ne zaman, nasıl veya hangi koşul altında tetiklendiğini kapsar.

  • URL, hatanın meydana geldiği web sayfasının URL'si olmalıdır. URL'yi tarayıcınızın adres çubuğundan kolayca kopyalayabilirsiniz.

  • Hatayı yeniden oluşturmanızı sağlayan adımları belgeleyin.

  • Gerçek Sonuç, bir veya daha fazla cümleyle son aksiyondan sonra ne olduğunu açıklamalı. Gerekirse önceki aksiyonların sonuçlarını ekleyebilirsin. Başlıkla aynı olmamalı.

  • Hata mevcut olmasaydı ne olması gerektiğini düşünün ve bu beklentiyi Beklenen Sonuç alanına yazın.

  • Hatayı görsel olarak göstermek ve varlığını doğrulamak için hatayı gösteren bir ek ekleyin.

  • Son olarak, döngüyü kabul ettiğinizde test etmek için davet edildiğiniz cihaza bağlı olarak test için kullanılan doğru Kullanılan Ortamı ve tarayıcıyı (varsa) seçmelisiniz.

Doğru Özelliği seçerek başlamalısın. Eğer doğru özelliği açılır listede bulamazsan, test genel bakış sayfasına geri dön ve tüm özellik açıklamalarını oku ve bunları okundu olarak işaretle. Sonra hata raporu formuna geri döndüğünde, tüm özellikler açılır listede görünecektir.

Hata Formu

Özelliği seçtikten sonra tüm hata formu karşına çıkacak. Örneğin, işlevsel hatalar için olan bir form şöyle görünür:

Her alanı kalite standartlarımıza uygun, doğru ve spesifik bilgilerle doldurmalısın. Her alanın gereksinimleri hakkında daha detaylı bilgileri aşağıda bulabilirsin.

Ciddiyet

Sadece işlevsel hatalar için ek bir Ciddiyet alanı göreceksin: Düşük, Yüksek ve/veya Kritik. Ciddiyet, raporunun aciliyetini belirler ve birçok faktöre bağlıdır. Farklı şiddet seviyeleri hakkında daha fazla bilgi almak için Fonksiyonel Hatalar makalesini ziyaret edebilirsin.

Ciddiyet alanı diğer hata türleri için görüntülenmeyecektir.

Başlık

Hata raporu başlığı, okuyucunun yalnızca başlığı okuyarak sorun hakkında genel bir fikir edinebilmesini sağlayacak şekilde hatayı özetlemelidir. Okuyucunun hatanın ne olduğunu anlamak için raporun tamamını okumasına gerek olmamalıdır. Hata raporu başlığınız açık, kısa ve öz olmalıdır.

İyi bir hata başlığı, sorunu anlamak ve onu diğer hata raporlarından ayırt etmek için gerekli bilgileri içerir. Gerekli bilgiler şunlardır:

  • Ne oldu?

  • Hata nerede meydana geldi?

  • Ne zaman, nasıl veya hangi koşul altında tetiklendi?

Bir hata başlığı yazarken, neler oluyor kısmını açıklayın, nelerin olmadığı kısmını değil. Başlığınız asla bir şeyin çalışmadığını belirtmemelidir, çünkü bu durumda okuyucu aslında ne olduğunu anlayamaz.


Başlık gerçek sorunu yansıtmalı. Hata sadece belirli koşullarda oluyorsa, bu koşullar başlıkta belirtilmeli. Örneğin, bir bileti rezerve edemiyorsan ve bunun nedeni genç olduğunu belirtmense, bu bilgi başlıkta yer almalı.

Açıklayıcı bir başlık bulmak için, kendinizi web sitesini/uygulamayı hiç test etmemiş, hangi sayfada olduğunuzu, neye benzediğini ve ne yaptığınızı hayal edemeyen birinin yerine koyun. Hatayı anlayıp anlamayacağınızı görmek için başlığınızı o kişinin bakış açısından okuyun. Hata hakkında iyi bir fikir edinemezseniz, hata başlığını değiştirin ve işlemi tekrarlayın.

Örnek hata başlıkları

Doğru

Yanlış

PayPal ile sipariş gönderilirken Checkout sayfasında bir hata mesajı görüntüleniyor

Checkout çalışmıyor

Oturum açmış bir kullanıcı tarafından açıldığında Cart sayfası 404 hatası görüntülüyor

Cart sayfası 404 hatası görüntülüyor

URL

Hatanın göründüğü sayfayı ziyaret edin ve tarayıcınızın adres çubuğundaki URL'yi kopyalayıp hata raporu formundaki URL alanına yapıştırın. URL geçerli bir URL olmalıdır.

Örnekler

Senaryo

Doğru URL

Yanlış URL

"Sepete Ekle" düğmesi bir Ürün Detay Sayfasında (PDP) tepki vermiyor

Düğmeye tıklanan Ürün Detay Sayfası (PDP) URL'si. Örnek: https://www.example.com/product/running-shoes

Başka herhangi bir sayfanın URL'si

Bir bağlantı 404 sayfasına yönlendiriyor

Bozuk bağlantıyı içeren sayfanın URL'si. Örnek: https://www.example.com/sale

404 sayfasının URL'si. Örnek: https://www.example.com/404

Üretmek İçin Adımlar

Hatalar tekrar üretilebilir olmalı ve bunun için adım adım bir rehber olmalı. Her adım ayrı bir işlemi anlatmalı.

Bu işlem sistemimiz tarafından otomatik olarak yapıldığından adımlarınızı numaralandırmanız gerekmediğini unutmayın.

İlk adım, bir web sitesini test ediyorsanız Access bölümünde sağlanan müşteri ortamının URL'sine erişme talimatını veya bir mobil uygulamayı test ediyorsanız uygulamayı (adıyla birlikte) açma talimatını içermelidir. Örnek:

Web siteleri için:

  1. https://test.io/ adresini açın

Mobil uygulamalar için:

  1. testNow uygulamasını açın

Diğer tüm adımlar, ilk adımdan hatanın oluştuğu ana kadar gerçekleştirdiğiniz işlemleri açıklamalıdır – hangi düğmelere bastığınız, hangi bağlantıları takip ettiğiniz ve neler girdiğiniz. Son adımınız, hatayı tetikleyen gerçekleştirdiğiniz işlemi açıklamalıdır.

Adımlarınız olabildiğince genel olmalıdır. Sadece hatanız belirli koşullar altında meydana geliyorsa, örneğin belirli bir ürün sayfası, belirli bir filtre veya belirli bir giriş gibi, bu koşulları adımlarınızda adlandırın. Örneğin, adımlarınızda belirli bir ürün sayfasına gittiğinizi ve sepete belirli bir ürünü eklediğinizi belirtmeyin, eğer sorun herhangi bir ürün için ortaya çıkıyorsa. Bu, okuyucunun hatanızın ne olduğunu anlamasına yardımcı olacaktır ve gereksiz ayrıntılarla dikkati dağılmayacaktır.

Son olarak, adımlarınızın mümkün olan en az sayıda işlem içermesine dikkat edin. Her adımı okuduktan sonra, hatanızı yeniden üretmek isteyen kişi web sitesi veya uygulamada bu adımları eksiksiz bir şekilde tamamlayabilmelidir. Aynı adımı hatırlamak için birkaç kez kontrol etmek zorunda kalmamalıdır.

Örnek adımlar

  1. Arama çubuğuna herhangi bir arama sorgusu girin (örn. "San Francisco")

  2. "Şimdi Ara" butonuna tıklayın

  3. Aşağı kaydırın ve "Sırala" butonuna tıklayın

  4. "Fiyata göre sırala: Yüksekten Düşüğe" seçeneğini seçin

Gerçek Sonuç

Gerçek sonuç, bir hata raporunun en önemli alanlarından biridir çünkü burada sorunun ne olduğunu ve hatanın anlaşılması için gerekli tüm detayları açıklarsınız.

Adım adım rehberinizi takip ettikten sonra gerçekte ne olduğunu olabildiğince net bir şekilde açıklayın. Olabildiğince kesin olmaya çalışın ve çok genel olmaktan kaçının, örneğin "Sıralama yöntemi X uygulandıktan sonra ürünlerin çoğu aynı sırada kalıyor" demek yerine, doğru sırada olmayan belirli ürün örneklerini tanımlayın. Bu alana hatayla ilgili olan tüm bilgileri ekleyin, örneğin örnekler, ek koşullar, istisnalar veya gerekliyse diğer önemli sonuçlar. Sadece bilgilerinizi, okuyucunun düşünme sürecinizi anlamasına yardımcı olacak şekilde yapılandırdığınızdan emin olun.

Önemli notlar: Gerçek sonuç ve beklenen sonuç hiçbir zaman birbirinin tam tersi olmamalıdır. Gerçekte ne olduğuyla ne olması gerektiği beklentisi arasında büyük bir fark olmalıdır.

Aynı şekilde, gerçek sonuç raporun başlığıyla aynı olmamalıdır. Başlık sorunun bir özetidir, gerçek sonuç ise sorunun ayrıntılı bir açıklaması olmalı ve senaryo bilgileri, örnekler ve hatanın yeniden üretim adımları sırasında elde edilen sonuçlar gibi ek detaylar içermelidir.

Örnek Gerçek Sonuç

Doğru

Yanlış

Kullanıcı Ödeme sayfasına ilerlemeye çalıştıktan sonra “Hata 500 - Dahili Sunucu Hatası - Üzgünüz, bir şeyler ters gitti” mesajı gösterilir.

Ödeme butonuna tıkladıktan sonra Sepet sayfasında hata gösteriliyor.

Ürün detay sayfasının (PDP) sağ üst köşesinde “Beklenmeyen Hata” mesajı görünür ve ürün sepete eklenmez.

Kullanıcı sepete ürün ekleyemiyor, bir hata gösteriliyor.

Beklenen Sonuç

Son olarak açıkladığınız adımı gerçekleştirdikten sonra ne olmasını beklediğinizi açıklayın. Hatayla karşılaşmamış olsaydınız, yani her şey doğru şekilde çalışsaydı ne olması gerektiğini düşünün.

Beklenen sonuç kısa bir açıklama içermelidir, ancak karmaşık hatalar için ek bilgilere ihtiyaç duyulabilir.

Beklenen sonucun, birkaç küçük değişiklik veya olumsuz ifadeyle yazılmış gerçek sonuç olmadığını unutmayın. Bu alan, hatayı yeniden oluşturmak için son adım tamamlandıktan sonra gerçekleşmesi gereken her şeyi açıklayabilmeniz için ayrı olarak tasarlanmıştır.

Beklenen Sonuç Örnekleri

Doğru

Yanlış

Checkout sayfası başarıyla yüklenmelidir.

Kullanıcı, Checkout sayfasına doğru şekilde yönlendirilmeli; burada teslimat ve ödeme bilgilerini ekleyebilmeli ve sipariş verebilmelidir.

"Batman T-Shirt" sepete eklenmeli, böylece kullanıcı sipariş işlemine devam edebilmelidir.

"Batman T-Shirt" ürünü sepete başarıyla eklenmelidir. Kullanıcı "Error 500" gibi hatalarla karşılaşmamalı ve sepetindeki ürünlerin satın alma işlemini tamamlayabilmelidir.

Ekler

Hatayla ilgili hangi eklerin eklenmesi gerektiğini ve hangi kuralların geçerli olduğunu öğrenmek için lütfen şu makaleyi ziyaret edin: Hata Raporu Ekleri İçin Gereksinimler.

Kullanılan Ortam

Hata ile karşılaştığınızda hangi cihazı kullandığınızı bilmemiz ve müşterilerimizin bunu öğrenmesi önemlidir. Bir web sitesini test ederken, kullandığınız cihazın yanındaki tarayıcı simgesine tıklayın. Bir mobil uygulama test ederken, uygulamanın yüklü olduğu cihazı seçin.

Test için yalnızca bu bölümde listelenen cihazları kullanabilirsiniz. Ayrıca, hatayı raporlarken yalnızca bir cihaz veya tarayıcı seçmeli ve sadece bu cihaza ait ekleri yüklemelisiniz. Hatayı diğer cihazlarda veya tarayıcılarda da yeniden üretebiliyorsanız, bunu Gerçek Sonuç alanında belirtmelisiniz.

Hatanın oluştuğu doğru ortamı seçmek zorunludur. Raporunuzu gönderdiğinizde doğru ortamı seçtiğinizden emin olun. Yanlış ortamı yanlışlıkla seçerseniz, raporu gönderdikten sonra bunu düzeltebilirsiniz. Ortam seçiminizi, ekip lideri hata raporunu incelemeden önce değiştirebilirsiniz. Hata raporu yanlış ortamı içeriyorsa, ekip lideri hata raporu incelemesi sırasında onu reddedecektir.

Profilinizde mevcut cihazlar listesinde olmayan bir cihazla test yapmak mı istiyorsunuz? Destek sohbeti aracılığıyla bize bir istek gönderin, cihazınız müşterilerimiz için uygun olduğu sürece cihazınızı listenize ekleyelim.

Not: Profilinizde davet aldığınız cihazı cihaz listenizden kaldırdığınızda, bu testte artık rapor gönderemezsiniz. Hata formunun ortam bölümü boş kalacak ve form gönderilemeyecektir. Profilinizde bir cihazı silme işlemi, bir test davetini kabul ettikten sonra geri alınamaz!

Raporunuzu Geliştirmek

Raporunuzu gönderdikten sonra, seçilen hata türü hariç tüm alanları düzenleyebilirsiniz. Her zaman incelenmeye hazır, eksiksiz hata raporları göndermelisiniz ve yalnızca küçük bir yazım hatası yaptıysanız veya rapor kalitesini artırmak için ifadelerinizi yeniden düzenlemek istiyorsanız Düzenle seçeneğini kullanmalısınız.

Yer tutuculara izin verilmediğini unutmayın, bu yüzden daha sonra düzenlemek için eksik raporlar göndermeyin.

Hatanız yalnızca belirli bir girdiyle oluşuyorsa, hata raporu veya ekleri oluştururken gerçek kullanıcılar tarafından kullanılacak terimleri kullanın ve rastgele anahtar kelimeler girmeyin. Kötü bir örnek, müşteri arayüzünde bir hesap oluştururken "asdsdfkg_lajsdh" gibi bir kullanıcı adı kullanmaktır, çünkü bu, raporunuzu profesyonel olmayan bir şekilde gösterir.

Yanlışlıkla bir hata raporu gönderdiyseniz, takım lideri henüz incelemediyse raporu silebilirsiniz.

Bu cevap sorunuzu yanıtladı mı?