| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN"> | |
| <html> | |
| <head> | |
| <meta http-equiv="CONTENT-TYPE" | |
| content="text/html; charset=windows-1252"> | |
| <title></title> | |
| <meta name="GENERATOR" content="OpenOffice.org 641 (Win32)"> | |
| <meta name="AUTHOR" content="Sophie Gautier"> | |
| <meta name="CREATED" content="20020327;10405745"> | |
| <meta name="CHANGEDBY" content="Sophie Gautier"> | |
| <meta name="CHANGED" content="20020412;12130878"> | |
| </head> | |
| <body lang="fr-FR"> | |
| <p><font size="4" style="font-size: 16pt;"><b>Guide de rapport de bogues sur | |
| IssueZilla</b></font></p> | |
| <p>Dernière mise à jour le 06 Août 2001 (traduction et adaptation française | |
| le 27 Mars 2002)</p> | |
| <p>Les parties françaises en italique sont la traduction des champs que vous | |
| rencontrerez dans le formulaire.</p> | |
| <p><b>Pourquoi devez-vous lire ceci </b> </p> | |
| <p>Simplement parce que le plus efficacement vous reportez un bogue, le plus | |
| rapidement un ingénieur le corrigera. Ce guide est un tutoriel général pour | |
| l'écriture efficace d'un rapport de bogues, par un utilisateur novice dans | |
| l'utilisation d'IssueZilla. Toutes les parties ne vous seront pas nécessairement | |
| utilies pour le bogue que vous reportez.</p> | |
| <p><b>Comment écrire un rapport de bogue efficace</b></p> | |
| <p style="margin-left: 1.03cm;">Un bogue bien reporté est un bug qui sera | |
| corrigé rapidement. Un bon bogue doit avoir deux qualités :</p> | |
| <ol> | |
| <li> | |
| <p><b>Reproductible.</b> Si un ingénieur ne le reproduit pas et n'arrive | |
| pas à prouver qu'il existe, c'est ingénieur va sûrement l'estampiller comme | |
| 'INVALID/<i>INVALIDE</i>' ou WORKSFORME/<i>NON REPRODUCTIBLE </i>et passer | |
| à un autre bogue. Chaque détail que vous pouvez donner est une aide précieuse</p> | |
| </li> | |
| <li> | |
| <p><b>Spécifique.</b> Le plus rapidement un ingénieur peut isoler le | |
| bogue comme un problème spécifique, le plus rapidement également il pourra | |
| le régler. (Si un programmeur ou un testeur doit déchiffrer un bogue, il | |
| passera plus de temps à maudire la personne qui a reporté le bogue qu'à | |
| essayer de le fixer ou de le tester.)</p> | |
| <p>Disons que l'application que vous testez est une feuille de calcul | |
| reçue comme document attaché </p> | |
| <p><b>Mauvais :</b> « Calc plante quand j'essaye d'ouvrir un document. | |
| Je pense qu'il contient un diagramme. Je suis sous Windows. Je pense que | |
| c'est un problème grave et que vous devriez le corriger maintenant. D'autre | |
| part vos icônes sont vraiment laides. Personne n'utilisera votre logiciel | |
| si vous conservez ces horribles icônes. Oh, ma grand-mère a un problème | |
| avec le traitement de texte. Rien ne marche non plus. Bonne chance ».</p> | |
| <p><b>Bon :</b> « Mon ordinateur se plante à chaque fois que j'essaie | |
| d'ouvrir la feuille de calcul attachée en utilisant la version 10.13.00 | |
| sous Win NT 4.0 (Service Pack 5). J'ai également essayé sous Linux (RedHat | |
| 6.2) et j'ai reproduit le problème toujours en utilisant la version 10.13.00 | |
| pour Linux.<br> | |
| Lorsque j'ai supprimé le diagramme du document, j'ai pu ouvrir le document | |
| sans problème. »</p> | |
| </li> | |
| </ol> | |
| <p style="margin-left: 0.03cm;"><b>Comment créer un rapport de bogue efficace | |
| dans IssueZilla</b></p> | |
| <p style="margin-left: 1.01cm;">Pour reporter un bogue, vous devez être inscrit | |
| comme utilisateur OpenOffice.org. Pour s'enregistrer, c'est très simple : | |
| cliquez sur le lien « Join/<i>Sincrire </i>» dans la barre de navigation | |
| et suivez les instructions. Cela ne prend que quelques minutes. Si vous êtes | |
| déjà enregistré, cliquez sur le lien « My Issues/<i>Mes Bogues </i>» sur | |
| la barre de navigation à gauche ou sur le lien « Bugs ans Issues » de la | |
| barre de navigation. La page suivante est une page explicative sur IssueZilla | |
| et indique également des liens utiles comme le lien d'interrogation de la | |
| base de données (Query<i>/Requête)</i></p> | |
| <p style="margin-left: 1.01cm;">Rendez-vous sur la page de recherche IssueZilla | |
| Query Page pour déterminer si le défaut que vous avez constaté est un bogue | |
| connu et a déjà été reporté (si votre bogue est reporté pour la 37e fois, | |
| vous allez plutôt embêter l'ingénieur et un ingénieur embêté est un ingénieur | |
| qui résoud moins de bogues !)</p> | |
| <p style="margin-left: 1.01cm;">Assurez-vous que vous avez pu reproduire | |
| votre bogue en utilisant une version récente. N'hésitez pas à faire appel | |
| à la mailing liste (<a href="http://www.openoffice-fr.org/">http://fr.openoffice.org</a>) | |
| pour que ce bogue soit reproduit par d'autres et sur d'autres systèmes d'exploitation. | |
| (Les ingénieurs sont souvent plus intéressés par des problèmes affectant | |
| le code base sur lequel ils sont en train de travailler, plutôt que ceux | |
| ayant trait à un code source déjà corrigé des centaines de fois et dont les | |
| bogues sont obsolètes).</p> | |
| <p style="margin-left: 1.01cm;">Si vous découvrez un nouveau bogue se rapportant | |
| à une version récente, entrez-le sur IssueZilla :</p> | |
| <ol> | |
| <li> | |
| <p>A partir de la page principale de IssueZilla, choisissez « Enter | |
| a new issue/<i>entrer un nouveau bogue </i>»</p> | |
| </li> | |
| <li> | |
| <p>Sélectionnez le <b>component/<i>composant</i></b> (ou module) dans | |
| lequel vous avez trouvé le bogue <br> | |
| IssueZilla demande que vous indiquiez un module dans lequel vous avez rencontré | |
| le bogue (si cette liste ne vous dit rien, cliquez sur le lien <a | |
| href="component.html">Component</a>, qui vous conduira à une page descriptive | |
| des différents éléments, afin que vous puissiez faire le meilleur choix)</p> | |
| </li> | |
| <li> | |
| <p>Entrez votre adresse e-mail, votre mot de passe et appuyez sur le | |
| bouton « Login » (Si vous n'avez pas encore de mot de passe, laissez la | |
| case « mot de passe » vide et appuyez sur le bouton « e-mail me a password/<i>envoyez | |
| moi un mot de passe </i>». Vous recevrez alors, rapidement, un mail avec | |
| votre mot de passe.</p> | |
| </li> | |
| </ol> | |
| <p><b>Maintenant, remplissez le formulaire. Voici ce qu'il signifie :</b></p> | |
| <p style="margin-left: 1.01cm;"><i>Où avez-vous trouvé le bogue ?</i></p> | |
| <p style="margin-left: 1.01cm;"><b>Reporter/<i>Rédacteur :</i></b><i> </i><b>Qui | |
| écrit ce rapport de bogue ?</b><br> | |
| C'est vous ! Pour entrer un bogue, vous devez être inscrit et «logué».</p> | |
| <p style="margin-left: 1.01cm;"><b>Component/<i>Composant :</i></b><i> </i><b>Dans | |
| quel module / composant / produit avez-vous trouvé ce bogue ?</b><br> | |
| Vous venez juste de remplir cela à la page précédente</p> | |
| <p style="margin-left: 1.01cm;"><b>Subcomponent/<i>Sous-composant :</i></b><i> | |
| </i><b>Dans quel partie du composant principal avez-vous trouvé ce bogue | |
| ?</b><br> | |
| Vous avez généralement le choix entre UI (User Interface/<i>Interface Utilisateur</i>) | |
| et code. Code est utilisé uniquement si vous connaissez l'emplacement du | |
| bogue dans le code source, sinon choississez UI.</p> | |
| <p style="margin-left: 1.01cm;"><b>Version/<i>Version :</i> Dans quelle version | |
| du produit avez-vous trouvé le bogue ?</b><br> | |
| Donnez le numéro de version, si possible.</p> | |
| <p style="margin-left: 1.01cm;"><b>Plateform/<i> Plateforme :</i> Sur quel | |
| type de plateforme avez-vous rencontré ce bogue ? </b>(ex SUN, PC)<br> | |
| Si vous savez que ce bogue est reproductible sur toutes les plateformes, | |
| choisissez « All/<i>Toutes </i>». Sinon sélectionnez la plateforme sur laquelle | |
| vous avez trouvé le bogue, ou « Other/<i>Autre</i> » si la plateforme n'est | |
| pas listée.</p> | |
| <p style="margin-left: 1.01cm;"><b>OS/<i>Système d'exploitation :</i> Sur | |
| quel système d'exploitation avez vous trouvé le bogue ? </b>(ex Linux, Windows | |
| NT)<br> | |
| Si vous savez que ce bogue est reproductible sur tous les systèmes d'exploitation, | |
| choisissez « All/<i>Tous</i> ». Sinon, sélectionnez le système sur lequel | |
| vous avez trouvé le bogue, ou « Other/<i>Autre</i> » si le système n'est | |
| pas listé.</p> | |
| <p style="margin-left: 1.01cm;"><i>Quelle importance a ce bogue ?</i></p> | |
| <p style="margin-left: 1.01cm;"><b>Resolution Priority/<i>Priorité de résolution | |
| :</i> Quelle urgence de correction demande ce type de bogue ?</b><br> | |
| Le choix par défaut est « 3 ». 1 est le choix le plus urgent, 5 le moins | |
| urgent.</p> | |
| <p style="margin-left: 1.01cm;"><b>Issue Type/<i>Type de bogue :</i> Est-ce | |
| une defect/<i>anomalie</i>, enhancement/<i>amélioration</i>, feature-request/<i>fonction | |
| demandée</i>, task/<i>tâche</i>, patch/<i>patch.</i></b><br> | |
| Par défaut le choix dans la liste est « defect/<i>anomalie </i>». (Pour déterminer | |
| le type de bogue le plus approprié, cliquez le lien « Issue Type/<a | |
| href="issuecycle.html"><i>Type de bogues</i></a> » pour avoir accès à une | |
| description complète des choix proposés ainsi qu'à la procédure de vote).</p> | |
| <p style="margin-left: 1.01cm;"><i>Qui va suivre ce bogue ?</i></p> | |
| <p style="margin-left: 1.01cm;"><b>Assigned to/<i>Assigné à :</i> Quel développeur | |
| va être responsable de la correction de ce bogue ?</b><br> | |
| IssueZilla va assigner automatiquement ce bogue à un ingénieur par défaut. | |
| Ce cadre de texte existe cependant pour vous permettre d'assigner directement | |
| la tâche à un ingénieur différent (pour voir la liste des ingénieurs chargés | |
| par défaut des différents éléments, cliquez sur le lien envoyant vers la | |
| liste des éléments « Component ».</p> | |
| <p style="margin-left: 1.01cm;"><b>CC/<i>Copie :</i> Qui d'autre va recevoir | |
| un e-mail concernant les changements apportés à ce bogue ?</b><br> | |
| Listez ici l'adresse complète des personnes qui doivent recevoir un e-mail | |
| concernant les changements apportés à ce bogue. Vous pouvez entrer autant | |
| d'adresses que vous le désirez, ces adresses doivent être séparées par une | |
| virgule, et sans espaces entre les adresses.</p> | |
| <p style="margin-left: 1.01cm;"><i>Que pouvez-vous dire d'autre à l'ingénieur | |
| au sujet de ce bogue ?</i></p> | |
| <p style="margin-left: 1.01cm;"><b>URL : Sur quelle URL avez-vous découvert | |
| ce bogue ?</b><br> | |
| Si vous avez rencontré ce bogue à une adresse particulière, merci de la (ou | |
| les) indiquer.</p> | |
| <p style="margin-left: 1.01cm;"><b>Summary/<i>Sommaire :</i> Comment pourriez-vous | |
| décrire ce bogue en 60 (ou moins) caractères ?</b><br> | |
| Un bon sommaire doit permettre d'identifier de manière unique et rapide un | |
| rapport de bogue. Autrement, les ingénieurs ne seront pas interpellés par | |
| votre rapport et leur attention ne sera pas retenue lorsqu'ils liront leur | |
| 10 pages de rapport de bogues.</p> | |
| <p style="margin-left: 1.01cm;">Un sommaire du style « Echec à l'installation | |
| sur une RedHat 7.0, kernel 2.2.14 » est utile. « Echec du logiciel » ou « Echec | |
| à l'installation » représentent des mauvaise exemples.</p> | |
| <p style="margin-left: 1.01cm;"><b>Description/<i>Description : </i>Que pouvez-vous | |
| dire d'autre à l'ingénieur au sujet de ce bogue</b><br> | |
| Essayez de détailler le plus possible le diagnostique du problème. Une description | |
| pas à pas, précise, est la meilleur façon de pratiquer.<br> | |
| <br> | |
| <br> | |
| </p> | |
| <p style="margin-left: 1.01cm;">Pour les crash, si vous pouvez apporter des | |
| indications additionnelles, cela peut aider :</p> | |
| <ul> | |
| <li> | |
| <p><b>Win 32 :</b> Si vous recevez une erreur de Dr Watson, veuillez | |
| noter le type de crash et le module dans lequel l'application crash.</p> | |
| </li> | |
| <li> | |
| <p><b>Unix</b> : Merci d'indiquer une trace de la pile</p> | |
| </li> | |
| </ul> | |
| <p style="margin-left: 1.01cm;"><b>Target Milestone/<i>Date butoire.</i></b> | |
| Considérez-le comme une date limite ; la cible est « non déterminé » ou « prochaine | |
| version » -- pour la plupart des bogues, utilisez « non déterminé ».</p> | |
| <p style="margin-left: 1.01cm;">Vous y êtes ! Après avoir vérifié vos entrées | |
| et possibles erreurs, pressez le bouton « Commit/<i>Envoyer </i>», et votre | |
| rapport de bogue va maintenant se retrouver dans la base de données d'IssueZilla.</p> | |
| <p style="margin-left: 1.01cm;">N'hésitez pas à accompagner votre description | |
| d'un exemple ou d'un document attaché.</p> | |
| <hr> | |
| <p style="margin-left: 1.01cm;">(Ce Guide a été écrit originellement pour | |
| Mozilla par Eli Godberg. Merci à Claudius Gayle, Peter Mock, Chris Pratt, | |
| Louis Surarez-Potts, Tom Schutter, et Chris Yeh pour leur contribution à | |
| ce document).</p> | |
| <p style="margin-left: 0.03cm;"><br> | |
| <br> | |
| </p> | |
| <br> | |
| </body> | |
| </html> |