Fr:Guide de Bugzilla

From NeoWiki

Revision as of 13:48, 5 December 2006 by Jgd (Talk | contribs)
(diff) ←Older revision | Current revision (diff) | Newer revision→ (diff)
Jump to: navigation, search

Un guide pour soumettre et évaluer des bugs dans NeoOffice Bugzilla

Contents

J'ai trouvé un bug ou bien je souhaite une amélioration de NeoOffice. Que dois-je faire ?

Avant de rapporter un bug dans NeoOffice...

  1. Assurez-vous que vous avez installé le dernier correctif ; allez ici http://www.planamesa.com/neojava/patch.php pour télécharger le dernier correctif. Nos développeurs bénévoles et doués corrigent des bugs constamment et votre bug peut avoir été déjà corrigé.
  2. Regardez si vous pouvez reproduire le bug (provoquez l'apparition du bug à plusieurs reprises) ; les bugs qui ne sont pas reproductibles sont très difficies à corriger.
    1. Regardez si vous pouvez reproduire ce bug après un redémarrage de votre Mac.
    2. Regardez si vous pouvez reproduire ce bug "avec une nouvelle configuration" ; parfois votre configuration peut être corrompue et provoquer un bug. Déplacez votr répertoire ~/Library/Preferences/NeoOffice-2.x (~/Library/Preferences/NeoOffice-1.x pour NeoOffice 1.2.x) à un autre emplacement et relancez NeoOffice.
    3. Si vous disposez de la version X11 d'OpenOffice.org, regardez si le bug est reproductible dans la version X11 correspondante (par ex., NeoOffice 2.0 Alpha équivaut à OpenOffice.org/X11 2.0.2 et NeoOffice 2.0 Aqua Beta équivaut à OpenOffice.org/X11 2.0.3); si c'est le cas, postez plutôt un rapport de bug à OpenOffice.org IssueZilla, car c'est un bug d'OpenOffice.org.
  3. Si le problème persiste, signalez le bug, suivez les instructions ci-dessous.

Demandes de fonctionnalités supplémentaires et d'améliorations

Nous ne répondons pas actuellement aux demandes de nouvelles fonctionnalités et d'améliorations des fonctions existantes. Étant donnés les changements rapides dans la nature de la plateforme Macintosh et le temps et les ressources dont disposent les développeurs, le projet NeoOffice se limite, pour le moment, à assurer le fonctionnement d'une version native d'OpenOffice.org sur Mac OS X. Regardez cette discussion sur trinity pour plus de détails.

Corriger les bugs dans les fonctions d'OpenOffice.org sort du cadre de ce projet. De même, la plupart des améliorations doivent être implémentées dans le code partagé et multipalteforme d'OpenOffice.org et leur demande doit plutôt être faite dans OpenOffice.org IssueZilla.

Rapporter un bug dans NeoOffice.org Bugzilla

  1. Avant de signaler un bug, cherchez si ce n'est pas un double afin d'être certain qu'il n'a pas été déjà signalé.
    1. Sélectionnez Query Bugs dans la page principale de Bugzilla.
    2. Sélectionnez NeoOffice dans le menu Project et entrez les termes à rechercher.
      • Ne rouvrez pas des bugs qui semblent similaires signalés dans des versions plus anciennes de NeoOffice (par ex., des bugs signalés dans NeoOffice/J 1.1 ou NeoOffice 1.2.2—tout bug ayant un numéro inférieur à 1000 ou clos avant Avril 2006, car l' interface de Bugzilla affichera incorrectement la valeur de la version pour des bugs anciens) ; dans presque tous les cas, le bug n'est pas le même, et ajouter des informations supplémentaires ne fera que rendre le problème plus confus. Au lieu de cela, choisissez Add a new Bug et signalez dans le nouveau rapport que votre bug semble similaire au bug nnnn qui a été signalé dans la version nn de NeoOffice.
      • Si vous trouvez un bug existant (UNCONFIRMED, NEW, ASSIGNED, ou REOPENED) qui ressemble au bug que vous voulez signaler, vous pouvez vous ajouter à la liste CC pour être avertis des développements nouveaux et des correctifs à tester. Si le bug est UNCONFIRMED (ou quelquefois REOPENED) et si vous avez des informations complémentaires qui peuvent aider à confirmer le bug (par ex., un moyen alternatif de le reproduire), n'hésitez pas à ajouter un commentaire contenant ces informations.
  2. Quand vous signalez un a bug, n'incluez qu'un problème (bug) à la fois ; cela permet de suivre et de corriger les bugs plus facilement.
  3. Soyez sûrs de sélectionner la version appropriée de Mac OS X et incluez le numéro de correctif (Patchlevel) de votre application NeoOffice.
    Ceci nous aide à déterminer si le bug existe seulement dans une version particulière de Mac OS X— comme c'est souvent le cas, les premières versions du 10.4 semblaient particulièrment "buggy"— et avec quel correctif le bug a commencé à apparaitre. Ne sélectionnez pas "All" comme version du système sauf si vous pouvez reproduire le bug sur Mac OS X 10.3.9 et Mac OS X 10.4.x PPC ou sur Mac OS X 10.4.x PPC et Mac OS X 10.4.x Intel.
    • Le numéro de correctif (Patchlevel) est indiqué dans la fenêtre "À propos de NeoOffice " accessible dans le menu NeoOffice.
    • La version de Mac OS X est indiquée dans la fenêtre "À propos de ce Mac" accessible dans le menu Pomme.
  4. Indiquez de façon détaillée les étapes nécessaires pour reproduire (provoquer) le bug ; les développeurs en auront besoin pour déterminer ce qui provoque le bug afin de pouvoir le corriger.
    Notez que OpenOffice.org et donc NeoOffice est un énorme programme, et que le développeur ou le membre de l'équipe QA travaillant sur votre bug peut ne pas être familiarisé avec la partie du programme dans laquelle vous avez découvert le bug. Donc plus vous fournirez de détails, plus il y aura de chances que quelqu'un soit capable d'utiliser votre rapport de bug.
  5. Attachez des documents illustrant le bug (captures d'écran, crash logs, exemples de documents, etc.) après avoir signalé le bug; le lien "Create New Attachment" n'est présent qu'aprés que le bug a été soumis.
    • Attachez une capture d'écran, si nécessaire.
    • Attachez le document qui pose problème, si nécessaire, ou envoyez-le par email à Patrick s'il c'est un document qui n'est pas destiné à être public.
      N.B. Attachez les documents à part (attacher un document efface les commentaires non encore soumis)
  6. Si vous signalez un plantage ou un blocage (le disque qui tourne indéfiniment), attachez un 'crashlog' (compte rendu de plantage) ou un échantillon (ne faites pas un copier/coller dans les commentaires)

Obtenir un 'crashlog 'ou un échantillon

Obtenir un 'crashlog' quand NeoOffice se plante

  • Option A: l'application CrashReporter est-elle activée ?
    Mac OS X a une application très appréciable appelée CrashReporter qui produit des rapports de crash quand les applications plantent. Elle est activée par défaut sur Mac OS X.
    1. Lorsque la fenêtre de dialogue annonçant "L'application NeoOffice a quitté inopinément" (ou "L'application soffice.bin a quitté inopinément") apparait, cliquez sur le bouton "Soumettre un rapport...".
    2. Copiez la totalité du contenu de la fenêtre "Rapport de Crash" et collez-le dans un nouveau document texte (dans TextEdit, créez un nouveau document et choisissez Convertir au format Texte dans le menu Format).
    3. Une fois le fichier texte sauvegardé, vous pouvez fermer la fenêtre de dialogue Rapport de Crash.
      N.B. L'intitulé des fenêtres de dialogue varient selon les versions de Mac OS X.
    4. Attachez ce crashlog au bug que vous signalez.
  • Option B: le moyen compliqué (vous avez probabement désactivé CrashReporter)
    1. Ouvrez l' application Console, située dans le sous-dossier Utilitaires du dossier Applications.
    2. Cliquez sur l'icône "Logs" de la barre d'outils si le panneau Logs n'est pas visible sur la gauche.
    3. Dans la liste des logs, sélectionnez "~/Library/Logs" puis "CrashReporter" et "soffice.bin.crash.log"
    4. Localisez l'entrée de log correspondant au plantage le plus récent. Ce devrait être l'une de celles situées en bas. Chaque entrée de log de plantage est séparée de la précédente par une ligne d'astérisques ; au début de chaque entrée figure une date.
    5. Sélectionnez l'entrée, depuis la ligne "Host name" jusqu'à la fin et collez-la dans un nouveau document texte (dans TextEdit, créez un nouveau document et choisissez Convertir au format Texte dans le menu Format).
      N.B. Le format du crashlog varie selon les versions de Mac OS X.
    6. Attachez ce crashlog au bug que vous signalez.

Obtenir un échantillon quand NeoOffice se bloque (affiche le disque qui tourne )

  1. Ne "forcez pas à quitter" NeoOffice
  2. Ouvrez l'application Moniteur d'activité, située dans le sous-dossier Utilitaires du dossier Applications.
  3. Quand vous le lancez, Moniteur d'activité, devrait afficher une fenêtre répertoriant les différentes "opérations" qui tournent sur votre Mac.
  4. Sélectionnez NeoOffice dans cette liste.
  5. Cliquez sur le bouton "Inspecter".
  6. Dans la fenêtre qui s'ouvre, cliquez sur le bouton "Échantilloner" dans le coin inférieur gauche ; cela générera un "échantillon" qui aidera les développeurs à déterminer pourquoi NeoOffice s'est bloquée.
  7. Lorsque l'échantillon est complet, enregistrez le fichier ; vous pouvez alors fermer la fenêtre d'échantillonnage et forcer NeoOffice à quitter.
  8. Attachez l'échantillon sauvegardé au bug que vous signalez.

Lectures complémentaires relatives au rapport de bugs

Les documents suivants, écrits par d'autres auteurs, proposent des réflexions supplémentaires sur les "bonnes méthodes" générales pour signaler des bugs :

Cycle de vie d'un Bug

Cette section explique chacun des "états" dans lequel un bug peut se trouver dans Bugzilla et comment un bug passe d'un état à un autre. Les deux états "Status" et "Resolution" dans Bugzilla sont expliqués.

Unconfirmed (Non Confirmé)

Tous les bugs commencent avec un statut de "Unconfirmed" et une resolution définie par "None".

À partir du statut "Unconfirmed", les bugs accèdent habituellement au statut "Assigned" si ce sont des problèmes reproductibles spécifiques à NeoOffice, "Closed" car "Duplicate" si un autre bug relatif au même problème a déjà été signalé, ou "Closed" comme "OpenOffice.org bug" si le bug existe aussi dans la version équivalente d'OpenOffice.org/X11. Les bugs "Closed" en tant que "OpenOffice.org bug" devraient être signalés par le rapporteur dans OpenOffice.org IssueZilla pour que les développeurs d'OpenOffice.org responsables pour ce problème le corrige, et la personne qui clôt le bug devrait avertir le rapporteur avec cette information (ne pas traduire) :

Closing as this is an OpenOffice.org bug as the bug occurs in OOo 2.0.3. [ou la version d'OOo équivalente à la version courante de NeoOffice]

Unfortunately, the current scope of the NeoOffice project is limited by resources to keeping a native version of OpenOffice.org running on Mac OS X and fixing OpenOffice.org feature bugs is outside that scope.

you can report the feature request in the OpenOffice.org issue tracker to get it on the radar of the core OpenOffice.org développeurs: http://qa.openoffice.org/issue_handling/pre_submission.html).

Quelquefois les bugs "Unconfirmed" sont aussi "Closed" comme "Not a bug" (si une fonctionnalité se comporte comme elle le doit, même si ce n'est pas de la façon dont le rapporteur pense qu'elle devrait le faire), "Closed" car "Won't fix" (le plus souvent ce sont des bugs de Mac OS X ou Java, qui ne peuvent être corrigés que par Apple), ou "Closed" car "Works for me" (si personne d'autre ne peut reproduire ce bug ou si les informations données sont insuffisantes pour en déterminer la cause). NOUVEAU Depuis janvier 2005, il est possible d'utiliser une nouvelle 'Resolution' : "Mac OS X bug" lorsqu'on clôt un bug provoqué par un bug (ou une fonction) de Mac OS X.

Duplicate (Double)

Lorsque des bugs sont "Closed" comme "Duplicate", le numéro du bug dupliqué est ajouté au champ "Add Dependency" du bug qui est clos, par ex., si le bug 1060 est un double du bug 1048, entrez 1048 dans le champ "Add Dependency" du bug 1060 lorsque vous lui attribuez le statut "Closed".

Certains bugs peuvent être des doubles d'autres bugs qui sont "Assigned", "Fixed" (si le rapporteur n'utilise pas la dernière version ou le dernier correctif), "New", ou "Closed" (toutes les résolutions sauf "Duplicate"; un bug ne peut pas être le double d'un double, le bug est donc signalé comme un double du bug original).

Si un bug est un double d'un autre bug "Unconfirmed", cetts situation est parfois suffisante pour justifier le passage du premier bug au statut "Assigned"— mais voyez ci-dessous quelles propriétés supplémentaires un bug devrait avoir avant d'obtenir le statut "Assigned". Dans le cas où deux bugs "Unconfirmed" sont des doubles l'un de l'autre, habituellement c'est le bug le plus ancien qui a le statut "Assigned" et le nouveau est marqué comme double. Cependant, si le rapport du bug le plus récent est plus clair, si plus d'informations, de documents sont fournis, etc…, alors le statut "Assigned" peut être attribué au nouveau bug et le plus ancien clos comme double du nouveau.

Assigned (Assigné)

Les bugs qui peuvent être reproduits par un développeur ou un membre de l'équipe de test se voient attribués le statut "Assigned" et sont assignés au développeur compétent pour le corriger. Généralement il ou échantillon de Mac OS X, etc.) avant que leur statut passe de "Unconfirmed" à "Assigned".

La plupart des bugs "Assigned" ont leur statut changé en "Resolved" avec une résolution "Fixed", mais les bugs qui ne peuvent pas être corrigés pour le moment ont comme statut "New" avec une résolution "Deferred". Les bugs "Assigned" peuvent aussi être changés en "Closed" car "Not a bug" ou "Closed" car "Won't fix" après que le développeur a étudié le problème et déterminé qu'il résidait ailleurs ou ne pouvait pas être corrigé.

Les bugs "Assigned" qu'un développeur a corrigés gardent souvent le statut "Assigned" (récemment "Assigned" avec comme résolution "Fixed" pour qu'ils ressortent mieux dans la longue liste "Assigned" ) jusqu'à ce que la correction apparaisse dans un correctif officiel ; à ce moment-là leur statut est changé en "Resolved" et la résolution en "Fixed" (et, une fois que la correction est intégrée dans une nouvelle version binaire, le statut est modifié en "Closed" et la résolution en "Fixed") ; dans tous les cas, seuls les développeurs devraient modifier le statut ou la résolution de bugs qui sont "Assigned" ou "Resolved".

New (Nouveau)

Ce statut est attribué aux bugs que les développeurs ont l'intention de corriger mais qu'ils ne peuvent pas corriger immédiatement pour une raison ou une autre ; à ces bugs est attribuée la résolution "Deferred".

Souvent des bugs se voient attribuer ce statut à cause de problèmes dans les logiciels sous-jacents (Mac OS X ou Java), dont nous savons qu'ils seront corrigés dans un version future de ces logiciels et seront peut-être corrigés lorsque les utilisateurs ou NeoOffice passeront à la nouvelle version. Certains bugs sont aussi notés "New" parce qu'ils sont corrigibles mais à cause d'un manque de développeurs ou de temps, ils ne peuvent pas être corrigés pour le moment et d'autres bugs ou des développements prioritaires sont plus importants.

Resolved (Résolu)

Les bugs qui sont corrigés sont "Resolved" en tant que "Fixed" une fois que le développeur a codé une solution qui corrige le bug. En temps voulu les développeurs publieront un correctif ("patch") qui inclura la correction de sorte que les utilisateurs puissent tester et assurer que le bug a bien été corrigé. Si un correctif ne corrige pas un bug, celui-ci devient "Reopened" ; une fois que le correctif a été inclus dans une version complète téléchargeable de NeoOffice (une "release", telle que NeoOffice 1.2 Alpha ou NeoOffice/J 1.1), le bug est "Closed". (Seul le développeur de la version devrait changer le statut d'un bug de "Resolved Fixed" en "Closed Fixed" ; cela garantit que la correction est intégrée à la nouvelle version et qu'aucun bug n'a été oublié.)

Reopened (Rouvert)

S'il apparaît qu'un bug qui était "Resolved" comme "Fixed" n'a pas été corrigé par un patch, le rapporteur du bug devrait changer le statut du bug en "Reopened" et remettre la résolution à "None". De même, si un bug qui était marqué "Closed" dans une certaine version de NeoOffice réapparait dans une version postérieure de NeoOffice il doit, lui aussi, passer à "Reopened" et "None".

Si un bug qui était "Closed" car "Works for me" est encore présent et si le rapporteur a de nouvelles informations ou un meilleur processus pour le reproduire, il devrait aussi être changé en "Reopened" et "None" (théoriquement il devrait être ramené au statut "Unconfirmed" et "None" jusqu'à ce que quelqu'un puisse reproduire le bug, mais notre bugzilla est "manuel" et ne dispose pas de la fonction "automatique" nécessaire).

Closed (Fermé)

"Closed" est le statut final de tous les bugs dans NeoOffice Bugzilla. les bugs corrigés et dont la correction est intégrée dans une version complète de NeoOffice sont marqués "Closed" et "Fixed".

Les bugs qui sont marqués "Closed" sans avoir été corrigés ont l'une des résolutions suivantes :

  • "Closed" comme "Duplicate", si un autre bug concernant le même problème a déjà été signalé ; Regardez la sous-section de Duplicate sous "Unconfirmed" pour plus d'information
  • "Closed" comme "OpenOffice.org bug", si le bug existe aussi dans la version équivalente d'OpenOffice.org/X11
  • "Closed" comme "Not a bug", si la fonctionnalité est conforme à ce qu'elle doit être, même si cela ne correspond pas aux attentes du rapporteur
  • "Closed" comme "Won't fix", habituellement lorsque le bug est en fait un bug de Mac OS X ou Java, qui ne peut être corrigé que par Apple, ou des bugs qui nécessitent un fonctionnement non souhaité par les développeurs ou l'utilisateur de base
  • NOUVEAU "Closed" comme "Mac OS X bug", si le problème est dû à un bug (ou une fonctionnalité) de Mac OS X.
  • "Closed" comme "Works for me", si personne ne peut reproduire le bug ou s'il n'y a pas d'information suffisante dans le rapport de bug pour en déterminer la cause

Verified (Vérifié)

Ce statut n'est pas utilisé du tout dans NeoOffice Bugzilla. Sauf si un bug "Fixed" est marqué "Reopened", le bug est considéré comme corrigé, de sorte qu'il n'est pas nécessaire de 'vérifier' qu'il l'est.

Diagramme

Le diagramme suivant présente une illustration graphique du cycle de vie d'un bug.

Cycle de Vie d'un Bug



Cliquez pour agrandir image (73 KB)


Cet article dans d'autres langues : English
Personal tools