Bienvenue chez MLO

Auto
Rapporter un bug (Mageia Bugzilla)
 




Cette page va vous aider à comprendre ce qu'est un bug, quand et comment ils doivent être rapportés et à quoi faire attention. Un rapport de bug soigné permet une bonne résolution. Les étapes sont là pour vous expliquer comment écrire de bon rapport.


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.




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 :

Code BASH :
# LC_ALL=C urpmi --debug vlc





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



Les éléments qui suivent concernent uniquement les bugs de la distribution. Pour ce qui est de l'infrastructure ou des sites Web, la même démarche qui suit est valable, c'est accessible ici

  • 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.


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"



Article traduit à partir de la page du wiki anglais ;)

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



 
Cette page a été vue 2118 fois