Bir sorunu yeniden üretme¶
Sorun yoksa, sorunu çözemezsiniz. Bu nedenle, sorunu çözmek için önce sorunu yeniden oluşturmak gerekir. Yazılımda, sorunlar genellikle "hata" olarak adlandırılır ve sorunlar genellikle "hata raporları" olarak adlandırılır.
Birisi bir hata raporu gönderdi. Rapor eden kişinin tarif ettiği adımların, bildirilen hataya yol açtığını doğrulamanız gerekir. Raporda tarif edilenleri aynen uygulayarak aynı sonucu elde edebiliyor musunuz? Eğer edemiyorsanız, bunun nedenini bulmanız gerekir.
Bir sorunu yeniden üretmeye başlamak için, bir geliştirme ortamı kurmanız gerekecektir.
Koddaki hatalar¶
İdeal bir durumda, hatayı bildiren kişiyle aynı kurulumunuz olacak, adımları takip edecek ve hatayı açıklanan şekilde yeniden oluşturabileceksiniz. Ancak çoğu durumda bu kadar basit olmayacaktır. Çoğu hata raporu sadece belirsiz açıklamalar ve belirsiz koşullar içerir. Sorun, birçok hatanın, etkileşim şekli, çeşitli ön koşullar, işletim sistemi, işletim sistemi sürümü, CPU mimarisi veya kullanıcının makinesinin eski ve yavaş mı yoksa yeni ve hızlı mı olduğu gibi ilgili koşullar kümesine göre değişmesidir. Hata ile ilgili durum hakkında ne kadar fazla bilgiye sahip olursak o kadar iyidir. Rapor eden kişinin sağladığı koşulları yeniden oluşturmaya çalışın. Bunu yapamıyorsanız, bir sonraki adımınız hatayı rapor eden kişiden daha fazla bilgi istemek olabilir.
Bir hatayı yeniden üretmenin en iyi yolu, sorunu hala gösteren mümkün olan en küçük örneği kullanmaktır. Çoğu zaman, rapor edenler minimum düzeyde geçerli bir örnek sunmazlar; herhangi bir örnek sunarlarsa, bu örnek "gerçek dünya" uygulamalarından doğrudan kopyalanır. Amacınız, raporu sorunu gösteren mümkün olan en basit forma indirgemek olacaktır. En iyi yeniden üretme örneği, mümkün olan en küçük programdır. Bu indirgeme, gerçek sorunun ne olduğunu belirlediği için yararlıdır. Herkes minimal örneği alıp çalıştırabilir ve açıklanan hatayı gözlemleyebilir.
Dokümantasyon hataları¶
Dokümantasyon hataları farklı şekillerde ortaya çıkabilir. Biçimlendirmeyle ilgili sorunlar, görüntüleme sorunlarına yol açabilir. Bazen bu bir hata bile olmayabilir; kişi belgeleri yanlış okumuş veya gerçekten bir hata yapmış olabilir. Bu, belgelerde bir sorun olmadığı anlamına gelmez. İçerik belirsiz veya kesin olmayabilir ve bu da karışıklığa veya yanlış yorumlamaya yol açabilir. Tartışılması gereken bir kavram, tamamen belgelenmemiş olduğu için tartışılmamış olabilir.
Bir dokümantasyon sorunu için hata bildirildiğinde, bildirilen sorunun gerçekten hala mevcut olup olmadığını doğrulamak isteyeceksiniz. Görüntüleme sorunları durumunda, sorunu yeniden oluşturabilmek için dokümantasyonu oluşturmanız gerekecektir. İçerik sorunları ise, hiç kimsenin güncelleme göndermediğini doğrulamak için okunması gereken bir konudur.
Sorunu güncelle¶
Triaj sürecinin son adımı, sorunla ilgili bir yorum bırakarak bulgularınızı belgelemektir.
Sorunu tam olarak anlatıldığı şekilde yeniden oluşturabilirseniz, söylemeniz gereken tek şey budur. Orijinal rapor eden kişinin tarif ettiği şekilde aynı sorunu gördüğünüzü doğruladığınızı belirten bir yorum bırakın.
Ek bilgi sağlayabiliyorsanız, bu bilgilerin ayrıntılarını da ekleyin. Bu, sorunu farklı bir işletim sisteminde veya ilgili yazılımların farklı sürümlerinde yeniden oluşturabilme veya orijinal rapordan farklı olan diğer herhangi bir bilgi olabilir.
Orijinal raporda, raporu yeniden oluşturmak için ihtiyaç duyduğunuz ayrıntılar eksikse, bu ayrıntıları ekleyin. Bu, orijinal raporda yer almayan işletim sistemi veya sürüm ayrıntılarını, daha eksiksiz günlükleri veya yığın izlerini veya sorunu yeniden oluşturmak için gereken işlemlerin tam sırasına ilişkin daha net talimatları içerebilir. Sorunu yeniden oluşturmak için daha basit bir yol geliştirdiyseniz (veya orijinal raporu hazırlayan kişi bir yeniden oluşturma örneği sağlamadıysa), bu yeniden oluşturma yönteminin ayrıntılarını ekleyebilirsiniz.
Sorunu yeniden oluşturabilirseniz, denediğiniz şeyleri ayrıntılı olarak açıklayan bir yorum da bırakın. Sorunun nerede olmadığını bilmek, nerede olduğunu bilmek kadar önemlidir, çünkü bu, olası nedenleri daraltmaya yardımcı olur. Sorunu neden yeniden oluşturamadığınızla ilgili herhangi bir teoriniz varsa (örneğin, kullanım hatası olduğunu düşünüyorsanız veya sorunun son işletim sistemi güncellemesiyle çözüldüğünü düşünüyorsanız), bu spekülasyonu yorumunuza ekleyin.
Son olarak, çekirdek ekibe önerilerde bulunabilirsiniz. Orijinal raporun hatalı olduğunu düşünüyorsanız, sorunun kapatılmasını önerin; sorunun nedeni hakkında bir teoriniz varsa, bunu da önerebilirsiniz. Yorumlarınız, çekirdek ekibin sorunu bir sonraki adıma nasıl taşıyacağını belirlemesine yardımcı olacaktır.
Bu noktada, az önce yeniden oluşturduğunuz sorunu [düzeltmeyi} deneyebilirsiniz; alternatif olarak, bulgularınızı yazabilir ve başka bir sorunu yeniden oluşturmayı deneyebilirsiniz.