Rapporter un bogue
Un article de Wiki de la communauté Mandriva.
Les bogues (ou bug/bugs en anglais), demande de nouvelles fonctionnalités et autres remarques doivent être rapportés sur le site http://qa.mandriva.com. Ce site utilise le système Bugzilla.
[modifier] Avant de rapporter un bogue
[modifier] Utilisez la dernière version du programme
Vérifiez que vous utilisez la dernière version du programme avant de soumettre un nouveau rapport de bogue. Votre problème est peut-être déjà résolu dans une version ultérieure à celle que vous utilisez.
Les logiciels intégrés à Mandriva Linux sont disponibles sous forme de paquetages RPM qui contiennent une liste des évolutions apportées au programme en question. Vous pouvez facilement consulter cette liste en utilisant le gestionnaire de paquetage.
Toujours essayer la dernière version d'un logiciel avant de rapporter un bogue ; ne pas rapporter de bogues au sujet d'anciennes versions.
[modifier] Effectuer une recherche sur Mandriva Bugzilla
Rappelez-vous que des milliers de gens rapportent quotidiennement des bogues ! Votre problème a peut-être déjà été signalé, pensez à faire une recherche minutieuse sur http://qa.mandriva.com avant de rapporter votre bogue !
Effectuez une recherche sur Mandriva Bugzilla afin de vous assurer que le problème auquel vous êtes confronté n'a pas déjà été rapporté, voire résolu. Notez bien que les doublons représentent une perte de temps considérable pour les développeurs.
Par défaut, Bugzilla n'effectue pas de recherche parmi les bogues marqués RÉSOLU. Vous pouvez étendre la recherche à tous les bogues en sélectionnant ALL dans le menu déroulant intitulé Status de la page de recherche simplifiée. Vous pourriez découvrir que votre bogue a déjà été rapporté, résolu et corrigé dans une version plus récente du paquetage. Notez que vous pouvez aussi effectuer une recherche avancée en utilisant des critères très précis.
Si vous n'êtes pas un habitué de Bugzilla, listez tous les bogues rapportés pour le programme qui vous pose problème. Observez attentivement cette liste. Si un vous découvrez un sujet se rapportant à votre problème, ajoutez-vous en CC (Copie Carbone) et ajoutez un commentaire en décrivant votre problème. Vous pouvez aussi voter pour ce bogue, ce qui aura pour effet de le confirmer ou d'augmenter son importance. Ceci en vue d'éviter les doublons. Un seul rapport de bogue bien fourni donne une meilleure image du problème que plusieurs rapports éparpillés.
[modifier] Soumettre un nouveau rapport de bogue
Si vous avez effectué des recherches pour vous assurer que votre rapport de bogue est le tout premier sur ce sujet,
[modifier] Créer un compte Mandriva Bugzilla
Pour être en mesure de rapporter un bogue, vous devez ouvrir un compte Mandriva Bugzilla. Cliquez sur Open a new Bugzilla account afin de remplir le formulaire d'enregistrement.
Les comptes standards on des privilèges qui vous permettent d'ajouter un bogue, d'ajouter des commentaires à des bogues existants et de changer le statut de bogues qui ont été créés avec ce compte. Avant la validation d'un nouveau bogue, Bugzilla cherchera dans la base de donnée les bogues similaires et vous demandera si vous êtes sûr de vouloir rapporter un nouveau bogue.
[modifier] Créer un nouveau rapport de bug
- Choisissez le lien Enter a new bug report (entrez un nouveau rapport de bug)
- Sélectionnez la version de la distribution en fonctionnement sur l'ordinateur où existe le problème avec le logiciel, puis appuyez sur le bouton Go. Attention, les vieilles versions n'accepteront plus de rapport de bogue.
- Entrez le nom du paquetage qui vous semble défaillant dans la boite de texte sous Type the package name or search term: puis cliquez sur Search. Vous pouvez utiliser la liste de paquetage du site Web ou du gestionnaire de paquetages de votre distribution pour l'identifier.
- Vous voilà sur la page du rapport de bogue proprement dit.
[modifier] Ecrire un rapport de bug
La première chose à faire est de sélectionner la version du paquetage. Normalement ce doit être la dernière. Vérifiez que c'est bien cette version qui est installée sur votre ordinateur.
Dans Summary écrivez un court titre qui résume le problème.
Dans Description, indiquez:
- Votre matériel, si c'est un problème lié au matériel.
- Décrivez exactement ce que vous faites pour provoquer l'apparition du bogue. Détaillez les étapes jusqu'au moindre fichier et moindres actions qui provoquent le problème.
- Dans le cas où une version précédente n'avait pas ce problème, précisez-le.
- Optionnel: Apporter une solution.
[modifier] Chercher soi-même la solution
Par tous les moyens, essayez de résoudre vous-même le problème et proposer ainsi une correction de bogue ! Une caractéristique fabuleuse du logiciel Open Source est que vous n'avez pas à attendre qui que ce soit pour corriger un bogue - vous pouvez le faire vous-même.
Vous pouvez proposer un début de solution, une idée ou même un patch ou demi-patch. Toute contribution est bienvenue.
[modifier] Documents joints au rapport de bogue
Les rapports de bogue dans Bugzilla sont malheureusement limités en longueur en raison d'un détail d'implémentation dans l'interface Web. Vous pouvez vous retrouver à utiliser des documents joints pour soumettre un long rapport de bogue.
Si vous avez un fichier de données qui est relié à votre problème (par ex. un fichier MP3 qui ne fonctionne pas avec xmms), vous pouvez le joindre à votre rapport de bogue. Faire cela accélère la résolution du bogue.
[modifier] Quand votre bogue est soumis pour correction
Les rapports de bogue ont différents statuts définis par mots-clés quand ils sont en traitement :
[modifier] Cycle de vie d'un bogue
UNCONFIRMED (non confirmé)
| |
| |---------<------------+
| | |
| NEW (nouveau) --->-- NEEDINFO (besoin d'infos)
| |
| |---------<------------+
| | |
| ASSIGNED(assigné)-->-- NEEDINFO
| |
| |
RESOLVED (résolu)
(FIXED, INVALID, DUPLICATE, WONTFIX, WORKSFORME) (corrigé, invalide, doublon, sans_suite, bogue_non_reproductible)
[modifier] Statut UNCONFIRMED (non confirmé)
Vous venez de soumettre un bogue et il attend que d'autres le confirment (disent qu'ils ont le même bogue). Le rapport de bogue qui a beaucoup de confirmations est prioritaire. Si votre bogue concerne une partie peu utilisée du logiciel, ou s'il se déclenche dans des cas particuliers, il peut rester à l'état UNCONFIRMED pour un long moment. Pour une meilleure réponse, trouvez d'autres personnes qui peuvent reproduire le même bogue pour ajouter des commentaires au vôtre.
[modifier] Statut NEW (nouveau)
Votre bogue est confirmé (ou : le mainteneur est d'accord qu'il y a un vrai problème) et attend pour être attribué à un mainteneur de logiciel spécifique.
[modifier] Statut ASSIGNED (assigné)
Un mainteneur de logiciel spécifique a été assigné pour traiter le rapport de bogue.
[modifier] Statut NEEDINFO (besoin d'informations)
Il manque des informations, et le mainteneur les attend. Les mainteneurs accordent une faible priorité aux bogues avec le statut NEEDINFO, puisqu'ils ne peuvent réaliser le correctif avant que l'information ne soit fournie. Quand vous fournissez l'information manquante, remettez le statut à NEW ou ASSIGNED pour que le mainteneur sache que le bogue doit être réexaminé.
[modifier] Statut RESOLVED/DUPLICATE (résolu, doublon)
Le mainteneur pense que ce bogue fait doublon avec un autre. C'est votre travail de lire soigneusement le rapport de bogue original et, si ce n'est pas vraiment un doublon, vous devez fournir des informations supplémentaires et rouvrir votre rapport de bogue
Un exemple de faux statut DUPLICATE est ici - 
bogue numéro 9450, bogue numéro 4629.
[modifier] Statut RESOLVED/INVALID (résolu, invalide)
Le mainteneur pense que ce n'est pas un bogue. Peut-être qu'il est normal que le logiciel fonctionne ainsi ; ou, peut-être que quelque chose ne va pas sur votre ordinateur pour le faire fonctionner ainsi. Si vous n'êtes pas d'accord, rouvrez le rapport de bogue et fournissez des informations supplémentaires.
[modifier] Statut RESOLVED/WORKSFORME (résolu, fonctionne pour moi)
Le mainteneur ne peut pas reproduire le bogue.
[modifier] Statut RESOLVED/OLD (résolu, ancien)
La version mentionnée n'est plus supportée, ou le bogue est déjà résolu.
[modifier] Contacter les mainteneurs de logiciels
Oui, votre rapport de bogue est important. Cependant, d'autres rapports sont peut-être plus importants que le votre ! Si vous ne pouvez pas résoudre le problème vous-même, vous devrez patienter pendant que le mainteneur cherchera une solution.
Merci de ne pas harceler les mainteneurs en les contactant trop souvent à propos de votre bogue. Si vous pensez que votre bogue est important, cherchez d'autres personnes pouvant corroborer le problème et compléter la description de ce dernier. Les bogues importants sont ceux qui affectent un grand nombre de personnes.
[modifier] Testzilla
Testzilla est une autre manière de tester la présence de bogues. Le mainteneur décrit une procédure classique à suivre pour utiliser un ou plusieurs logiciels et le testeur l'effectue et indique à la fin si un bogue s'est produit. Plus d'informations sur la page Testzilla.
[modifier] Pour plus d'information
Les liens suivant (en anglais) apportent un complément d'information sur la gestion des bogues avec Mandriva Linux :
