Rapporter un bug (Mageia Bugzilla)

<img src="/upload/logo_mageia_1.png" alt="logo_mageia_1" title="logo_mageia_1" class="valign_" />

<span class="message-helper warning">La langue utilisée est l'Anglais, donc abstenez vous d'écrire en français, trois phrases simples et précises sont mieux qu'un long discours, ainsi le recours au traducteur en ligne est une bonne option. Les canaux IRC ou encore le forum peuvent également être une source d'aide si besoin.</span>

Définition

Que ce qu'un bug ?

Un bug est l'expression utilisée pour décrire une erreur, un incident, défaut ou encore irrégularité.

Mais les bugs ne sont pas restreints aux logiciels. Ils peuvent être partout, dans les applications, les éléments matériels, les personnes.

Donc basiquement, si un problème est reproductible, dans la documentation, la traduction, le graphisme, le site web, l'infrastructure ou bien encore dans le projet Mageia.Org, de ses contributeurs ou équipes de travail, il peut être reporté en tant que bug.

Les demandes de paquets sont également considéré comme un bug. Voir vers la fin.

Règles

• Soyez précis
• Soyez clair, expliquez de façon que les autres puissent reproduire le bug
• Un seul bug par rapport de bug
• Aucun bug n'est trop trivial pour être reporté, les petits peuvent en cacher de gros.
• Faites la distinction entres les fait et les spéculations
• Toujours lancer les applications avec le préfixe 'LC_ALL=C' qui vous permet de les exécuter en anglais facilitant donc le dialogue entre tous les protagonistes.
  
  

exemple :

Préliminaires

• Dans la mesure du possible essayez de reproduire le bug avec une version la plus à jour de l'application en question
• Allez sur la page de recherche pour voir si votre erreur est déjà connue
• En utilisant le préfixe ALL pour le premier terme de la recherche, bugzilla cherchera aussi dans les bugs fermés (mais pas forcement résolus)
• Si "votre" bug est dans la liste, vous pouvez laisser un commentaire, voire même ajouter des infos demandées si vous pouvez les fournir.
• N'hésitez pas à demander de l'aide sur les forums et sur les canaux IRCs.
  
  

Rapporter un nouveau bug

• Connectez vous sur le bugzilla avec votre identifiant Mageia, si vous n'en n'avez pas c'est par ici.
  
  ***note*** (attention le bugzilla permet de voir les adresses email en clair pour les utilisateurs enregistrés et dans les archives des actions du bugzilla, non indexées par les moteurs de recherche)
• Puis allez vers "File a bug" et choisissez Mageia
• Puis vient le choix des différents champs:
  
  

Component

Correspond à la sous rubrique du produit "Mageia"

• "Installer" correspond au bug relatif à l'installateur classique présent sur les isos DVD ou dual (non live)
• "New rpm package request" pour les demandes de paquets, voir plus bas
• "RPM Packages" Bug relatif a tous les paquets, si vous ne savez pas quel choix prendre, utilisez celui-ci.
• "Release (media or process)" pour les aspects techniques ou politiques relatifs à la distribution Mageia
• "Security" pour tout ce qui est du domaine de la sécurité et critique au sein de la distribution.
  
  

Version

Dans quelle version de la distribution se situe le bug ?

2 pour Mageia 2 (version stable actuelle), Cauldron la version de développement (future Mageia)

Hardware Platform

Sur quelle architecture reproduisez vous le bug ?

i586 est pour 32bits, x86_64 est pour la 64bits, et all est pour toutes. L'architecture arm n'est pas encore disponible.

Source RPM

Il s'agit du RPM correspondant à l'endroit où se trouve l'erreur.

Par exemple, si vous savez que le problème se situe dans le deamon mysqld, exécuté ainsi "rpm -qif /usr/sbin/mysqld". Cela vous donnera le nom et la version du rpm en question. Ce que nous cherchons pour le rapport de bug est le champ SOURCE RPM, qui est ici MySQL-5.0.27-1mga1.src.rpm.

Alternativement vous pouvez utiliser "rpm -qf /usr/sbin/mysqld --qf '%{SOURCERPM}\n" pour obtenir la même information.

Si vous ne connaissez pas l'emplacement de la source du problème "rpm -qf `which mysqld`" est également un moyen. Dans tous les cas l'équipe de triage du bugzilla reste présente si quelque chose devait être incomplet.

URL

Cela peut être un lien qui montre le problème ou une discussion relatif a celui-ci sur un forum, un rapport de bug upstream - en amont (pour le projet en lui même), ou dans une autre distribution.

Summary

Le résumé de votre bug.

Un bon résumé est quelque chose qui décrit le problème avec des mots clés précis et clairs, tout le reste est inutile comme par ex: "please... in my mageia 2 take from yesterday"



*Quelques mauvais exemples

mail crashed

Software crashes



*leurs équivalents en bons exemples

crash in Evolution while checking for new POP mail

Cancelling a File Copy dialog crashes File Manager

Details

C'est ici que se retrouveront tous les détails de votre rapport de bug, notamment:

Description of problem

Description plus complète que le résumé, soyez le plus précis et clair en décrivant votre problème tout en restant concis



Mauvais exemple: I can't seem to login to the system. Please help!



Bon exemple: I'm unable to login to the system via ssh.

The /var/log/messages log indicates there is a problem with the pam module pam_ldap, but the /etc/pam.d/system-auth file doesn't contain that module and I'm not using LDAP. I looked at /etc/pam.d/sshd and it does contain that module but I'm not sure how it got there, unless it was due to the super-spiffy super-ldap-mojo package I installed yesterday.

Version-Release number of selected component (if applicable):

Les paquets pouvant être mis en cause dans le rapport de bug (si possible)



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

How reproducible:

Fréquence de la reproduction du bug



ex: Every time I attempt to login.

Steps to Reproduce:

Étape nécessaire afin de reproduire le bug. Veuillez inclure tout ce qui peut-être spécifique à votre cas.





# ssh user@host

# see the rejection



Si vous avez un logiciel qui 'crash' l'utilisation de GDB en plus de lancer le logiciel en console peut aider dans la résolution.

(Sinon pour la suite les mainteneurs/développeurs ou équipes de tri peuvent vous demander plus d'informations si besoin.)

Attachment

Si vous avez besoin de reporter une capture d'écran ou des logs de votre problème l'utilisation des fichiers attachés est très encouragée et conseillée. D'autant plus que des liens vers des plateformes externes pour l'hébergement de photos ou de texte arrivent souvent à expiration après un certain temps (donc fortement déconseillé).

Dans tout les cas, si vous avez des logs longs, dans un premier temps supprimer les choses qui vous paraissent inutiles (42 fois la même ligne) et puis sinon ajouter un fichier joint.

L'article https://www.mageialinux-online.org/wiki/obtenir-une-backtrace-pour-ouvrir-un-rapport-de-bug vous indique comment obtenir une trace d'un plantage, ce qui peut être utile dans certains cas.

Assignee

Si vous connaissez la personne qui s'occupe du problème vous pouvez ajouter son adresse email, sinon laisser le champ vide, ce sera donc l'équipe du bugzilla qui ce chargera de cela en cas de besoin.

Vérification

Vérifier que l'ensemble vous semble complet puis cliquer sur "commit".

Votre bug est maintenant dans la base du bugzilla.

Soyez attentif aux mails que vous recevrez de sa part, il s'agira des actions faites sur votre bug.

Pour répondre à une demande, il vous faudra à nouveau passer par l'interface Web, et non pas envoyer de courriel privé vers la personne (sauf explicitement demandé).





[1], [2] : La commande "rpm -qi package" vous donnera beaucoup d'informations sur un paquet.

Comment faire une demande paquets

Afin d'avoir une liste cohérente , merci de bien respecter les indications suivantes:

• Pour le résumé utiliser la forme: <nom_de_l_application>, <brève_description>
  
  par exemple vagrant, a tool to build virtualized environments with VirtualBox
• Sélectionner la catégorie "New RPM package request" ( Component field)
• Ajuster la sévérité à "enhancement" (severity)
• Ajouter un lien vers la page du projet dans le champs "URL"
  
  

<span class="message-helper notice">Article traduit à partir de la page du wiki anglais </span>

Écrit par: leuhmanu, Le: 08/05/12