NASIL:Bugzilla'da hata kaydı ayıklamak
PardusWiki, özgür ansiklopedi
Bu belge Pardus'un resmi hata kayıt sistemi Bugzilla'ya girilen yanlış veya eksik hata kayıtlarının nasıl ayıklanması ve düzenlenmesi gerektiğini anlatır. Öte yandan bu işe soyunup Hata Avcısı olmak isteyen kişilerin kabaca hangi özelliklere sahip olması gerektiği hakkında fikir verir.
Konu başlıkları |
[değiştir] Hata kayıt sistemi
Önce kısaca hata kayıt sisteminden bahsedelim. Hata kayıt sistemi, diğer adi ile [Bugzilla], Pardus ve ürünlerinin (örn: Tasma, Kaptan, Yali...) kullanımı sırasında ortaya çıkan hataların kullanıcılar tarafından geri bildirimini sağlayan sistemdir. Bugzilla kesinlikle teknik destek servisi değildir. Örneğin; "Masaüstümdeki simgeleri yanlışlıkla sildim, nasıl geri getirebilirim?" yada "pisi up komutu bütün depoyu indiriyor!!!" başlıklı bir hata Bugzilla için "Geçersiz" bir hata kaydıdır. Bu ve benzeri kullanıcı hatasına veya yanlış anlamaya dayalı hata kayıtları, kullanıcılara kısa bir açıklama yapılarak kapatılmalı, bununla birlikte kullanıcı daha iyi yardım alabileceği [Pardus Kullanıcıları Listesi]'ne yönlendirilmelidir.
Hata kaydı girilirken nelere dikkat edilmesi gerektiğini öğrenmek için [Hata Raporlamak] başlıklı belgeyi okuyabilirsiniz.
[değiştir] Hata kayıtlarının takip edilmesi
Hata kayıtlarını düzenlemek isteyen kişi için en önemli nokta, hata kayıtlarının takip edilmesi işidir. Her gün eklenen yeni hata kayıtları bir yana, daha önceden bildirilmiş hata kayıtlarının da (bunlara yapılan yeni yorumlar yada verilen cevapların) takip edilmesi gereklidir. Özellikle hangi hatanın; hangi bileşene, kime, hangi öneme sahip olması gerektiği gibi önemli şeyleri anlamak için, eski hataların izlenilmesi/incelenmesi çok önemlidir. Daha önce bildirilen hatalar için istenen ek bilgiler büyük olasılıkla ileride bildirilecek benzer hatalar için de gerekli olacaktır.
Hata kayıtlarını takip edebilmek için en etkili yöntem [Bugzilla Listesi]'ne üye olmaktır. Böylece Bugzilla üzerinde gerçeklesen her hareketi takip edebilme şansınız olur. Yeni açılan hata kayıtları listede otomatik olarak New: ön eki ile başlıklandırılır böylece; hakkında hiç bir fikriniz olmayan eski hataları görmezden gelip, yalnızca yeni hatalara odaklanabilirsiniz.
Hata takibi için bir diğer yöntem'de Bugzilla içindeki [Arama] fonksiyonunu kullanmaktır. Gelişmiş Arama seçeneğini kullanarak arama için gerekli kriterleri (takip etmek istediğimiz hataların zaman dilimi, konusu yada durumu gibi özelliklerini) belirleyebiliriz. Böylece; örneğin son bir hafta içinde Tasma için açılmış hataları listeleyebilir, bunları inceleyebiliriz.
Eski hataların incelenmesi hata kaydı düzenleyecek kişi için gerçekten çok önemlidir. Özellikle, yeni açılmış bir hata kaydı için izlenilmesi gereken yol, genelde eski bir hata kaydında saklıdır. Daha önce okuduğumuz ve hafızamızın bir köşesine yazdığımız hata bildirimlerini, bir süre sonra tümüyle hatırlamamız pek mümkün olmadığından, ilgili olabilecek hataları aramak, bize yol gösterecek hatayı bunların içinden bulup incelemek kritik öneme sahiptir.
[değiştir] Tanımlar ve terimler
Şimdi biraz hata kayıtları ile ilgi tanım ve terimleri inceleyelim.
- Durum/Çözüm: Hatanın durumu hakkında bilgi verir. Olası durum ve çözümler şunlardır:
- NEW: Yeni bir hata kaydı girildiğinde durum'u New(yeni) olarak görünür.
- RESOLVED veya CLOSED: Bir hata çözülmüş veya belirli bir sebepten dolayı kabul edilmediyse durumu Resolved(karar verildi) veya Closed(kapandı) olarak değiştirilir ve her durumda sebebini anlatan ufak bir açıklama eklenir. Kapatılan hatalar 6 alt başlık altında toplanır.
- FIXED: Hatayı ortaya çıkaran durum ortadan kaldırıldığında, yani sorun düzeltildiğinde Fixed(düzeldi) olarak işaretlenir.
- INVALID: Geçerli olmayan hata kayıtları Invalid(geçersiz) olarak işaretlenir.
- WONTFIX: Bazı hatalar geliştiriciler tarafından görülmesine/bilinmesine rağmen belli sebeplerden dolayı çözül(e)meyeceklerine karar verilir. Bu durumda hata Wontfix(düzeltilmeyecek) olarak işaretlenir.
- REMIND/LATER: Çözümü bilinen ancak zaman darlığı yada başka bir sebeple sonra çözülmesi planlanan hatalar Remind(hatırlat) yada Later(sonra) olarak işaretlenir.
- WORKSFORME: Kimi hatalar kullanıcının bir şeyleri yanlış veya eksik yapmasından kaynaklanıyor olabilir. Bu durumda ortada geliştiricinin düzeltebileceği bir hata yoktur. Böyle hatalar Worksforme(bende çalışıyor) olarak işaretlenir.
- DUPLICATE: Birbirinden habersiz girilen iki hata aynı sorunu tarif ediyor olabilir yada iki farklı hatanın kaynağı aynı olabilir. Takibinin kolaylaşması açısından bu tür hatalar Duplicate(aynısı) olarak işaretlenir.
- ASSIGNED: Bir hatanın çözümü üzerinde çalışmaya başlayan kişi hatayı sahiplenir böylece başkalarının aynı hatayla vakit kaybetmesi engellenir. Sahiplenilen hatalar Assigned(atanmış) olarak işaretlenir.
- Ürün: Hatanın hangi ürüne ait olduğunu belirtir. [Ürün Listesi]
- Bileşen: Ürünler tek başlarına yeteri kadar belirleyici olmadığından bir de o ürüne ait bileşen seçilmelidir. Hata kayıtlarında en çok hata yapılan kısımlardan biri bileşen kısmıdır.
- Atanan Kişi: Hata ile ilgilenecek kişiyi belirtir.
- Web Adresi: Hata ile ilgili bir web adresi bildirilmek istendiğinde kullanılır. Hatayı giren kişinin kişisel yada en sevdiği web sitesinin adresini yazması için değildir. Özellikle yeni paket talepleri için kullanılır.
- Özet: Aynı zamanda hata başlığıdır.
- Öncelik: P1'den P5'e doğru hatanın önceliği artar. Genelde hatayı giren kişi tarafından değilde hata sahibi tarafından değiştirilmesi uygundur.
- Önem: Bu tanımda birçok kullanıcının kafasını karıştıran tanımlardan biridir. Bir çoğu hatanın kendisine göre ne derecede önemli olduğunu düşünüp değiştirir. Oysa bu hatanın hatayı bildiren için öneminden çok, hatanın Pardus'un genel kullanıma önemini belirtir. Önem bilgisini kullanıcıdan ziyade hata sahibi değiştirmelidir.
[değiştir] Hata kayıtlarının düzenlenmesi
Bugzilla'da hata kaydı düzenlemek isteyenlerin neyi nasıl yapması gerektiğini yüzeysel olarak tarif edelim.
[değiştir] İnceleme
Hata kayıtları üzerinde değişiklik yapmadan önce mutlaka incelenmesi gerekir. Hata doğru anlaşılmazsa yapılacak değişiklikler, gerçek bir hata kaydını geçersiz olarak işaretlemek yada yanlış bileşene atamak gibi daha büyük sorunlara yol açabilir. Bunu engellemek için şunları anlamak/yapmak iyi olacaktır:
- Hata tam olarak nedir?
- Hata Pardus'un kodlarından mı kaynaklanmakta yoksa kullanıcı hatasına mı dayanmaktadır?
- Aynı hata daha önceden bildirilmiş midir?
- Hata için uygun Ürün/Bileşen seçilmiş midir?
- Hata sahibi doğru atanmış mıdır? (Sıkça yapılan yanlışlardan biri hata sahibi olarak hatayı girenin kendisini atamasıdır!)
- Hata özeti hatayı yeterince iyi anlatıyor mu?
[değiştir] Tartışma
İnceleme safhasında bir şeylerin yanlış olduğu düşünülür ancak emin olunamazsa en iyi çözüm bunu diğer Hata Avcıları ile tartışmak yada geliştiricilere sormaktır. Üzerinde tartışılarak hem sorun daha iyi irdelenir hemde varılacak sonuç daha doğru olur. İletişim için net bir yol belirlenmemekle birlikte irc.freenode.org üzerinden #pardus-devel kanalına girerek büyük ihtimalle hata kaydını tartışabileceğiniz birilerini bulabilirsiniz.
[değiştir] Değiştirme ve kapatma
Hata kaydında değiştirilmesi gereken alanlardan emin olduktan sonra kullanıcı girişi yapılarak hata üzerinde değişiklik yapılabilir.
Not: Ürün/Bileşen değişikliklerinde hata sahibi otomatik olarak değiştirilmediğinden, gerekli değişiklik hatayı sahibine atama seçeneği (Reassign hata to owner of selected component) işaretlenerek yapılmalıdır.
[değiştir] Tavsiyeler
Hata Avcısı olmak isteyen kişiler bir süre hata takip sistemini takip etmeli, hangi durumlarda nasıl hareket edildiğini görmelidir. Eski hata kayıtlarını araştırmalı, gerekirse 'Hata Faaliyetini Görüntüle' seçeneğini kullanarak kimler hata üzerinde ne gibi değişiklikler yapmışlar bunları incelemelidir. Özgür yazılımın tüm diğer alanlarında olduğu gibi katılımcılık esastır, çekinmeye sıkılmaya gerek yok. Hata avcılığı için özel yetenekler gerekmez ancak devamlılık önemlidir.
