Guide pour le rapport de bogues
Bugzilla est un outil de traque des bogues utilisé par le Projet Fedora pour obtenir le retour des utilisateurs et des développeurs concernant les bogues et les demandes pour le perfectionnement de Fedora.
Ces rapports font perdre leur temps aux développeurs: mal classés, les bogues sont souvent ignorés ou oubliés.
Parfois, les nouveaux rapports de bogues sont incomplets, imprécis ou ont d'autres défauts. De tels rapports font perdre du temps aux développeurs qui ne le passent pas à corriger les bogues. Parfois même, ces bogues sont ignorés ou oubliés. Cette page donne des indications pour rapporter efficacement des bogues ou suggérer des améliorations de manière constructive.
Notes
- Le Projet Fedora a l'objectif d'être une plate-forme construite exclusivement depuis le libre et les logiciels ouverts. Les suggestions pour inclure des logiciels propriétaires ou d'autres logiciels qui posent des problèmes de licence ne servent à rien. Consultez la page ForbiddenItems (en) pour plus de détails à ce propos.
- Si un paquetage logiciel particulier est très utilisé, il est plus probable que des utilisateurs trouvent des bogues ou des suggestions pour celui-ci. Cela ne signifie pas que ce logiciel est plus bogué que les autres.
- Les développeurs ne valident généralement pas les rapports de bogue ni ne les commentent à moins qu'ils ne fournissent un retour très constructif ou qu'ils aient besoin de plus d'informations de votre part. Cela ne veut pas dire que votre rapport de bogue n'a pas été utile. Continuez à les faire parvenir !
- L'équipe de triage Fedora est actuellement à la recherche de nouveau volontaires. Si vous êtes intéressé, veuillez consulter la page BugZappers (en).
- Bugzilla ne liste seulement que les paquetages source. Si par exemple vous avez besoin d'effectuer un rapport de bogue à propos de mount, vous pouvez trouver les sources du paquetage en utilisant les commandes suivantes.
rpm -q --qf "%{SOURCERPM}\n" -f /bin/mount
Sortie :
util-linux-2.13-0.10.pre5.src.rpm
Pour commencer
- Si vous n'avez jamais utilisé le Bugzilla de Fedora, la première étape est de vous créer un compte sur celui-ci. C'est un processus rapide, n'hésitez pas à commencer tout de suite :
https://bugzilla.redhat.com/bugzilla/createaccount.cgi (en)
- Lisez la FAQ pour les détails importants concernant Bugzilla :
https://bugzilla.redhat.com/bugzilla/page.cgi?id=redhatfaq.html (en)
- Quand vous rapportez un bogue, il est important que vous choisissiez les bons Produit, Version et Composant. En faisant cela vous soulagerez le développeur/mainteneur du paquetage auquel il est affecté, et aiderez à résoudre les bogues plus rapidement. Si vous assignez cela à un mauvais composant, il peut être réassigné au bon, donc ne faites jamais l'économie d'un rapport de bogue uniquement parce que vous ne savez pas à quel composant l'assigner.
Guide de l'utilisateur respectueux
Comprendre le Statut et la Résolution
Après avoir rapporté un bogue, vous pouvez obtenir des réactions d'autres utilisateurs, et parfois un développeur peut modifier le "status" et/ou la "résolution" du rapport de bogue. Pour comprendre la signification de ces opérations:
https://bugzilla.redhat.com/bugzilla/page.cgi?id=fields.html#bug_status (en)
Rapporter des Bogues
Demandes d'Améliorations
Lorsque vous demandez l'ajout de nouvelles fonctionnalités, ajoutez le mot-clé « FutureFeature » au rapport. Veillez à fournir assez d'informations et à faire preuve de logique afin qu'elles soient examinées.
Sécurité
Nous faisons particulièrement attention aux bogues concernant la sécurité. Lisez la page Security Bugs (en) afin de comprendre ce processus particulier.
Déboguage
- StackTraces (en)
- JavaStackTraces (en)
Noyau
Si votre rapport concerne un blocage du système ou un plantage du noyau, vérifiez que la cause n'est pas due à un problème matériel :
HardwareProblems (en)
Le numéro exact de version, la sortie des commandes lspci et ifconfig, d'autres informations matérielles et un résumé de tous les autres changements que vous avez pu avoir effectués sont très utiles. Si vous utilisez un noyau personnalisé, indiquez-le plutôt sur bugzilla.kernel.org .
Xorg
Des informations sur le déboguage de Xorg dans Fedora sont disponibles sur la page Xorg Debugging (en).
OpenOffice.org (OOo)
OOo est un programme plutôt gros, utilise et est lié à un grand nombre de choses, et par conséquent soulève un grand nombre de problèmes qui ne sont pas toujours des bogues d'OOo, ce qui fait que :
- Un plantage au démarrage peut-être lié à certaines bibliothèques OpenGL, pas à OOo lui-même.
- Prenez la source de test sur [1] .
- Lancez
gcc testgl.c -o testgl -L/usr/X11R6/lib -lX11 -lGL
pour la compiler. - Si cela plante de nouveau, votre bogue ne vient probablement pas d'OOo.
- Si cela se produit sur votre machine x86_64, rappelez-vous qu'OOo est une application 32-bits, que Firefox est 32-bits sur la même plate-forme, regardez donc s'il y a le même problème.
- Vérifiez si d'autres applications similaires se comportent de la même façon. Par exemple, si Firefox, gedit et glxgears ont le même problème qu'OOo, il y a peu de chance que ce soit un bogue d'OOo.
- Si une boîte de dialogue de plantage apparaît, collez la trace de la pile d'exécution qu'elle vous donne dans le rapport de bogue.
- Indiquez si vous utilisez KDE ou GNOME étant donné que cela importe souvent. Si vous avez installé des thèmes KDE non fournis par Fedora, essayez un de ceux supportés.
- S'il y a un message d'avertissement ou d'erreur, indiquez ce qu'il dit.
- Si cela se produit avec un document particulier, joignez-le au rapport de bogue. Si vous le pouvez, réduisez le document à la plus petite partie de texte qui provoque le problème. « Défilez jusqu'à la page 912 et le graphique est mal placé » est beaucoup moins intéressant que d'avoir un exemple d'une seule page.
- Si vous pensez qu'il y a quelque chose qui ne va pas dans ce qui est affiché, joignez une capture d'écran. Il se peut que je ne puisse pas comprendre votre description.
Exemple : « la police de la formule est fausse »
Est-ce que c'est la police utilisée dans la zone de texte pour l'édition de la formule ou est-ce que c'est la police utilisée pour afficher la formule ? Vouliez-vous parler de l'éditeur mathématique ou de formules dans la calculatrice ? Une capture d'écran répondrait à ce genre de questions.
- Essayez de ne pas marquer pour les bogues des commentaires du genre « et ce programme - sans rapport avec le reste - ne marche pas » ou « ouais ça l'a corrigé, mais il y a un autre truc qui n'est pas toujours pas comme je voudrais » -- il est très compliqué de s'occuper de bogues mutants. Il n'y aucun problème avec le fait d'ouvrir plusieurs bogues, et il est plus facile de les fusionner s'ils s'avèrent être la même chose que de les séparer en bogues distincts.
- Si vous savez qu'il y a quelque chose d'inhabituel dans votre configuration, signalez-le.
Exemples :
- Dire « Des documents .doc créés avec MSWord lancés sous Wine ne s'ouvrent pas dans OOo » plutôt que simplement: « Des fichiers .doc ne s'ouvrent pas dans OOo »
- Signaler « Un enregistrement dans un partage Samba ne marche pas » est plus précis que: « je ne peux pas enregistrer »
- Si vous le pouvez, installez le débogueur et essayez :
$> gdb /usr/lib/openoffice.org/program/soffice.bin (gdb) run -writer (gdb) bt
Collez la trace de la pile d'exécution dans votre rapport de bogue.
(-writer
devrait être changé en conséquence : -calc -impress -math -draw
)
- C'est bien quand quelqu'un trouve qu'un bogue a été résolu dans une mise à jour et le mentionne dans un bogue ancien et encore ouvert, mais il est inutile d'ajouter une note spontanée en disant que le problème est encore là.
- Les commentaires du type « C'est inacceptable » ne sont pas très motivants.
Références
http://www.chiark.greenend.org.uk/~sgtatham/bugs.html (en)