Wiki » Bir hata doğru bir şekilde nasıl bildirilir

Other languages Deutsch ; English ; Français ; Nederlands ; Português (Portugal) ; Türkçe ; português brasileiro ;

Bu sayfa, hataların ne zaman, nasıl bildirilmesi ve nelere dikkat edilmesi gerektiğini anlamanıza yardımcı olması için hazırlanmıştır. Geçerli raporlanmış hatalar büyük ihtimalle onarılacaktır. Burada ki ana esaslar raporlamanın nasıl yapılacağını anlatmaktadır.

Önemli not: yaygın kullanılan dil İngilizcedir, bu yüzden lütfen diğer dillerde hata bildirimi yapmayın. Eğer bu konuda yardıma ihtiyacınız olursa forum veya IRC kanalları ile iletişim kurmaktan çekinmeyin.

Tanımlama

Tam olarak "bug" nedir? Bug, yaygın söylenişiyle istenmeyen şekilde davranan, yanlış veya beklenmedik sonuç üreten bir sistemdeki veya bir bilgisayar programındaki arıza, kırılma, eksiklik, sorun veya kusurdur. Fakat bir bug yazılım ile sınırlı değildir. Bug'lar her yerde olabilir. Yazılımda, donanımda ve bunlardan herhangi birinin bakımını yapan kişilerde. Bundan dolayı aslında eğer yeniden üretilebilir bir problem varsa, belgeleme, çeviri, sanat çalışması, website veya altyapısı, hatta Mageia.Org'un kendisi, takım örgütlenmeleri ile katkıcılardan biri veya benzer herhangi bir şey bir bug olarak bildirilebilir. Ayrıca bazı paketleri yapmak veya düzenlemek için yapılan paket istekleri de bug'dır.

İlkeler

• Dikkatli ol.
• Net ve açıklayıcı ol, böylelikle diğerleri hatayı açıkça anlayabilmeli.
• Her bug için ayrı bildirim yap.
• Bug (hata) yeniden üretilebilmeli - Eğer bildirmek istediğiniz bug sizin açıklamalarınızla yeniden üretilemiyorsa (yeni bir Mageia kurulumunda veya başka bir bilgisayarda) onarılma şansları çok düşüktür - geliştiricilerin hataları onarabilmesi için çoğunlukla hataları yeniden üretebilmeye ihtiyaçları vardır.
  • Eğer birisi sorunu yeniden üretebilirse veya birisi aynı sorunu gördüyse diye forumda veya eposta listelerinden birinde soru sormak her zaman iyi bir fikirdir.
• Hata bildireceğiniz yazılıma ait hata raporunu uygun yerde (örneğin bir KDE hatası için https://bugs.kde.org/ adresinde, systemd hatası için https://bugs.freedesktop.org adresinde) aramayı deneyin.
  Elbette sorunuz için Google'da basit bir arama da yapılsa iyi olur veya eğer bu bilinen bir problem değilse benzerini soruşturmak için de arama yapmayı deneyin.
• Bildirim için önemsiz bug yoktur- Küçük hataların altında daha büyük hatalar yatıyor olabilir.
• Gerçeği tahminlerden açık bir şekilde ayırın.
• Lütfen programı çalıştırıken her zaman başına LC_ALL=C ekleyerek çalıştırın. Bu şekilde hata mesajları veya diğer çıktılar İngilizce olarak gösterilecektir. Örnek vermek gerekirse;
  Komutu, urpmi paketadı olarak değil, LC_ALL=C urpmi paketadı olarak çalıştırın.

Ön hazırlıklar

• Yazılımınızın önceden onarılıp onarılmadığını görmek için, daha güncel bir derlemesini kullanarak hatanızı yeniden üretin.
• Hatanızın önceden bildirilip bildirilmediğini görmek içinse, https://bugs.mageia.org adresine gidin ve Bugzilla'da arama yapın.
  • Konuyla ilgili kavramlara bakarak hızlı arama'yı kullanabilirsiniz.
  • Aramada, konuyla ilgili önemli kavramları yazmanız çözümleri de içeren konuyla ilgili tüm hata bildirimlerinin size görünmesini sağlayacaktır.
  • Eğer "sizin" hatanızın aynısından varsa ve aynısı olduğuna eminseniz önceden yapılmış bu bildirimin altına hata ile ilgili bir yorum yazabilirsiniz. Hatanın sizinkiyle aynı olup olmadığından emin değilseniz IRC üzerinden veya forum aracılığıyla yardım alabilirsiniz.

Yeni bir hata raporlama

Eğer yazılımın daha güncel bir derlemesiyle hatayı yeniden ürettiyseniz ve başka hiç kimse bu hatanın bildirimini yapmadıysa bildirimi şu şekilde yapabilirsiniz:

1. Hesabınızla oturum açın (Öncelikle bir hesap yaratmanız gerekiyor, Mageia.org kullanıcı hesabı sayfasına bakın) ve [[1]] giriş yapın.
2. "File a Bug" seçeneğinin üzerine tıklayın (bu işlemi arama ile aynı hatayı bulmadıysanız yapın).
3. "Bir yeni hata girişi" seçin. Yönlendirme formu veya varsayılan formu kullanabilirsiniz.
4. Bulduğunuz hataya uygun ürünü seçin, (yalnız uzman form ile kullanılabilir). Yönlendirme formunda "Mageia" önseçmelidir. Mageia websitesi veya altyapı üzerine (Mageia Bugzilla veya buildsystem gibi) hata bildirimi için varsayılan forum kullanın (yukarı bakın).
5. Paketin RPM^[1] kaynağını girin.
6. Formu dodurun.

Formu anlamanıza bir miktar yardımcı olacak alan isimleri:

Component: Yazılıma uygun bileşenin seçileceği yer. Bu alan boş geçilemez ve doldurulması gereklidir. Her bir bileşenin tanımlamasını görmek için "Component" penceresindeki seçeneklere tıklayın. Eğer hiçbiri uygun görünmüyorsa, "RPM paketleri"ni seçin.

Version: Dağıtım sürümünün seçileceği yer. 1 ilk kararlı sürümdü, 4 en son kararlı sürümdür, cauldron ise geliştirme sürümüdür.
Eğer Mageia'nın iki veya daha fazla sürümünde hata olduğunu biliyorsanız, yüksek sürüme ayarlayın ve beyaz tahtaya düşük sürümleri ekleyin. Cauldron "4"den daha yüksektir, bu yüzden tüm sürümler için geçerli olan bir hata için:

• Sürümü Cauldron'a ayarlayın
• Beyaz tahta üzerine MGA1, MGA2, MGA3, MGA4'ü de yazın

Hardware Platform: Mimarinin seçileceği yer. i586'nın anlamı 32bit'tir, x86_64'ün anlamı 64bit'tir, arm ise ARM mimarisidir ve "hepsi"nden kasıt tüm mimarilerdir. En yaygın olanı ikincisidir.

Source RPM: Burası hata bildiriminin içindeki RPM paketini tam olarak tanımlayabildiğiniz yerdir. Örneğin, Eğer sahip olduğunuz sorunun mysqld programından olduğunu biliyorsanız rpm -qif /usr/sbin/mysqld komutunu çalıştırın. Bu size, diğer bilgilere ilaveten RPM paketinin sürümünü ve adını verecek (MySQL-5.0.27-1mga1 gibi). Özellikle "Source RPM" alanı için arama yapıyorsanız (MySQL-5.0.27-1mga1.src.rpm gibi) gereken bilgiyi bu şekilde sağlayabilirsiniz. Alternatif olarak rpm -qf /usr/sbin/mysqld --qf '%{SOURCERPM}\n' komutunu da kullanabilirsiniz. Eğer sözkonusu programın yerini bilmiyorsanız öğrenmek için rpm -qf `which mysqld` komutunu kullanabilirsiniz.

URL: Gönderdiğiniz sorunu gösteren URL'yi yazacağınız alan (İsteğe bağlı). Bu URL, orjinal sorunun raporlanmış olduğu bir forum iletisi, bir hata raporu akışı veya sizin sorununuza benzer başka bir dağıtımın hata raporu da olabilir.

Summary: Yaklaşık 60 veya daha az karakter ile hatayı nasıl tarif edersiniz? Güzel bir özet bir hatayı çabuk ve mükemmel bir şekilde tanımlayabilmeli. Özet, sorunu açıklamalı çözüm önerinizi değil. Lütfen açıklayıcı olun ve anahtar kelimeleri çok kullanın.

• Güzel örnek: Yeni POP posta için kontrol yaparken Evolution çöktü
• Kötü örnek: Posta çöktü
• Güzel örnek: Dosya kopyalama iletisini iptal edince Dosya yöneticisi çöktü

• Kötü örnek: Yazılım çöktü
• Kötü örnek: Tarayıcının benim web sitemde çalışması gerekiyor

Details: Probleminizin ayrıntıları:

Description of problem: Özetin genişletilmesi ve daha ayrıntılı bilgi. Lütfen hatanın ne olduğu mümkün olduğunca açık olsun.

• Kötü örnek: Sisteme girişte görünmüyorum. Lütfen yardım edin!

• Güzel örnek: SSH üzerinden sisteme giriş yapamıyorum. /var/log/messages günlük dosyası pam_ldap pam modül ile ilgili bir sorun olduğunu gösteriyor fakat /etc/pam.d/system-auth dosyası bu modülü içermiyor ve ben LDAP kullanmıyorum. /etc/pam.d/sshd dosyasına baktığımda modülü içerdiğini görüyorum ancak oraya nasıl geldiğinden emin değilim, yoksa dün kurduğum super-spiffy super-ldap-mojo paketinden dolayı olabilir mi?

Version-Release number of selected component (if applicable): (Seçilmiş bileşenin Sürüm-Yayım numarası (Uygunsa))

openldap-2.3.34-5mga1, pam-0.99.7.1-2mga1

How reproducible: (Hatanın yeniden nasıl ürettildiği)

Her zaman giriş yapmaya çalışıyorum.

Steps to Reproduce: (hatayı yeniden üretme adımları) Özet, hatayı başlatacak olan izlemesi kolay adımlar. Herhangi bir özel kurulum adımlarını kapsar.

1. ssh user@host
2. reddedilmesini görmek

Parçalanma arızaları için: Parçalanma arızası (segfault) oluşturan veya çöken yazılım sorununda hata ayıklama bilgisinin (geri izleme) sağlamanın nasıl olduğunu öğrenmek için yazılım çökmelerini ayıklama sayfasına bir göz atın.

• Eğer yardımı dokunacaksa bir dosya ekleyin (Tüm günlükleri eklemeyin, sadece sorununuzla ilgili olanı ekleyin)

Triyaj (Öncelik belirleme) ekibinin işini azaltacak olan, hata raporunuza gerekli daha özel bilgilerin olup olmadığını görmek için öncelik belirleme rehberine bakabilirsiniz.

• Eğer biliyorsanız görevlendirme için paket geliştiricisinin^[2] epostasını girin (bilmiyorsanzı Triyaj ekibi ekleyecektir)

Hata ve unutma ihtimaline karşı raporunuzu en az iki kere kontrol edin ve daha sonra "Gönder" butonuna basın. Hata raporunuz hemen Bugzilla veritabanında olacaktır.

[1], [2]: rpm -qi paketadı komutu size paket hakkında bir çok bilgi verecektir.

Bu sayfanın bazı kısımları https://landfill.bugzilla.org/bugzilla-3.6-branch/page.cgi?id=bug-writing.html adresinden alınmıştır.

Paket isteği yapma

Paket isteği yapmak bir hata başvurusuna benzer fakat istenen bilgilerde bazı farklılıklar vardır.

• https://bugs.mageia.org adresine gidin.
• Paketin gerçek adı ile "ALL <paketadı>" veya "<paketadı> şeklinde bir hızlı arama yapın.
  • Eğer birisi isteği önceden yapmışsa Mageia'da görmek istediğiniz paket için bir yorum ekleyin.
  • Eğer talep WONTFIX olarak kapatıldıysa, bu büyük bir olasılıkla projenin kaynağının ölü olmasındandır. Bu durumda genellikle bir alternatif Mageia paketi adı verilecektir.
  • Eğer hızlı arama ile hiçbir şey bulamadıysanız, bir sonraki adıma geçin:
• File a Bug seçeneğine tıklayın.
• Mageia seçeneğine tıklayın.
• (Component:) penceresinden "New RPM package request" seçeneğini seçin.
• (Version:) penceresinden "Cauldron" seçeneğini seçin.
• (Hardware Platform:) kısmından "All" seçeneğini seçin.
• (Source RPM:) kısmına paketin adını girin (Bir yansı için url girmeyin).
• (URL:http://) kısmına paketin kaynak linkini girin.
• (Summary) buraya "paket adını", "program amacının kısa bir özetini" girin.

Örnek: vargant, Virtualbox ile sanallaştırma oluşturmak için bir araç.

• (Details) alanına, yazılımı niçin önemli bulduğunuzu ve neden ihtiyaç duyduğunuzu anlatın. Eğer varsa Mandriva 2010.2'de paketin olduğunu söylemeyi unutmayın.
• (Severity) kısmından "Enhancement" seçeneğini seçin.
• Raporu gönderin.

Bug departmanı

Kaynak

https://wiki.mageia.org/en/How_to_report_a_bug_properly

Çeviren: Fırat Kutlu