Outil de suivi des anomalies

From Second Life Wiki
Revision as of 09:35, 20 December 2008 by Phli Foxchase (talk | contribs)
Jump to navigation Jump to search

Emblem-important-red.png Avertissement

La traduction de cet article est obsolète. Pour accéder au contenu le plus récent, veuillez vous reporter à la version anglaise.

Si vous le souhaitez, vous pouvez participer à la mise à jour de la traduction de cet article en vous inscrivant à la page Community Translation Project. set version=2

Update Needed

This article needs an update to reflect recent changes in the base article located at Issue tracker. When you're done with the update, change the {{Help/CODE|Parent=Issue tracker|BugFixes=*}} part to {{Help/CODE|Version=2|Parent=Issue tracker|BugFixes=*}}. Thank you for your help!


Deux choses à noter avant de commencer :

Cartella blu.jpg
Info.png
Les contributions
   

Toutes les contributions à JIRA sont soumises au Contribution Agréement de Second Life. En y ajoutant des corrections ou toutes autres informations, vous reconnaissez avoir pris connaissance, compris et approuvé les termes.

Cartella blu.jpg
Info.png
L’Utilisation
   

Le JIRA n'est pas destiné aux demandes de support technique.
S'il vous plait n'ajoutez pas de demandes qui exigent une réponse personnalisée. Pour une assistance spécifique à votre compte, utilisez plutôt notre support.

Exemples à traiter avec le support et non dans JIRA :

  • "Je ne peux pas modifier mes coûts de location"
  • "Une partie de mon inventaire a disparu"
  • "Quelqu'un a volé mes L$"


Le site JIRA, consultable à l'adresse http://jira.secondlife.com, est une base de données qui référence les bugs et les propositions des résidents de Second Life. Vous pouvez y retrouver et compléter les problèmes que vous rencontrez sur les clients ou le site officiel de Second Life. Cette page a pour but de vous familiariser avec JIRA.

Plus précisément, JIRA est un outil de gestion des anomalies destiné à la gestion de projet et édité par Atlassian. Il est utilisé par la communauté open source de Second Life et peut être également nommé JIRA Public, PJIRA, ou plus simplement JIRA.

Comment JIRA marche

Il y a deux principaux types de demandes : les bugs et les propositions.

  • Un rapport de bug est composé d'une description du problème et d’un moyen de reproduction si possible.
  • Une proposition inclue une description détaillant le principe de la nouvelle fonctionnalité souhaitée.
  1. Les demandes sont affichées aux autres utilisateurs qui peuvent les compléter.
  2. Les demandes les plus populaires accumulent les votes.
  3. Les programmeurs de la communauté open source peuvent joindre leurs corrections ou détailler les modifications nécessaires.
  4. Les votes et les réunions de tri aident à prioriser les fiches.
  5. Les demandes approuvées par Linden Lab sont ensuite importées dans le JIRA privé de Linden Lab pour être étudiées et corrigées.


L'avancement d'une demande importée est visible par son statut :

  • Dès que les modifications sont réalisées et en attente d’intégration dans le client, la demande reçoit le statut "Fix Pending" ("Correction en attente").
  • Une fois la modification ajoutée au client et après confirmation de la correction par l’équipe qualité de Linden Lab et les résidents, la demande passe à "Resolved" ("Traitée") ou "Closed" ("Fermée").


Une demande peut aussi être fermée si elle doublonne une autre demande, est non reproductible, mal classée, incomplète, n’est pas un bug, etc.


Signaler un bug / Proposer une fonctionnalité

Si vous vous sentez perdu et ne savez pas par où commencer, regardez cette vidéo (15 minutes) :

<videoflash>Jofq8ClPfNg</videoflash>

Guide de signalement des bugs

  • Fournissez toujours les étapes à suivre pour reproduire le bug (et numérotez-les !) Nous pouvons étudier un bug UNIQUEMENT si nous pouvons le reproduire. Plus un bug se reproduit facilement, plus vite il peut être corrigé.
    • Par exemple, au lieu de dire "Je crash quand j'importe des fichiers", la description devrait être (par exemple) :
  1. 1. Je clique sur Fichier > Importer Image ($L10)...
    2. Je choisis un fichier .TXT au lieu d'un fichier .JPG
    3. Je clique sur Ouvrir
    4. RESULTAT : mon ordinateur crash. Aucune fenêtre d'incident n'apparaît.
    • Vous pouvez envoyer cette explication à un ami. Si votre ami arrive à suivre les étapes, il y a de fortes chances que nous le puissions aussi!
  • N’hésitez pas à ajouter des images, des vidéos, des rapports d'incident (log de crash) ou tout autres fichiers liés à votre anomalie (dans la limite de 10 Mo chacun). Dans l’exemple précédent, il pourrait être intéressant,par exemple, de joindre le fichier que vous avez essayé d’importer.
  • N’expliquez qu’un seul problème par fiche. Chaque bug a besoin de sa propre fiche afin d’être suivi individuellement.
  • Recherchez votre anomalie dans les fiches existantes avant d’en créer une afin d’éviter les doublons
  • Lorsque vous décrivez un bug, évitez d’utiliser les noms de résidents ou de donner des renseignements personnels. Si le bug a un impact limité à vous même, à une sim ou à très peu de personnes, vous devriez commencer par contacter le support technique via son portail.

Restez à jour

  1. Consultez les Release Notes pour connaître les dernières évolutions du client. Des informations sur un nouveau bug ou une note sur une modification intentionnelle peuvent y figurer. Par exemple, l’interdiction de vente de terrain pour 0 L$ est une fonction voulue, pas un bug !
  1. Vérifiez que vos pilotes graphiques sont à jour. Pour les utilisateurs expérimentés, les Pilotes Omega sont des versions modifiées et couramment utilisées.

Savoir si un bug a déjà été signalé

Avant de signaler un bug, vous devez préalablement vérifier s’il n’y a pas des informations sur le sujet dans le portail du support ou si un rapport récent fait état de problème ponctuel sur la grille.

Eviter les doublons est très important. Leur gestion représente un important travail de tri (tant pour les Lindens que pour les résidents) et cela peut vous frustrer en vous donnant la fausse impression qu’une fiche est ignorée ou moins suivie qu’une autre. Il est plus efficace de concentrer le suivi d’un bug sur une fiche unique d'autant plus que les fiches les plus actives ont bien souvent une plus grande priorité de correction.

Après vous être connecté, vous verrez le tableau de bord. Depuis ce point vous avez accès à des filtres de recherche vous donnant accès aux fiches les plus récentes. Par exemple, vous pouvez choisir d’afficher toutes les fiches non résolues (non corrigées ou non étudiées) pour chaque projet. Une fois ce premier filtre appliqué, révisez le filtre pour affiner la recherche.

Vous pouvez créer et enregistrer vos propres filtres ou lancer de nouvelles recherches depuis la zone de « Recherche Rapide ». Cette recherche est indispensable avant de décider de créer une nouvelle fiche.

Si vous constatez que votre bug est déjà signalé, plusieurs actions s’offrent à vous :

Laisser un commentaire contenant des informations supplémentaires :

  • Une autre façon de reproduire un bug,
  • Voter pour la fiche pour signaler que vous la trouvez importante.
  • Meilleures seront les informations reportées, meilleures seront les chances d'obtenir une correction rapide.


Signaler un bug

Pour signaler un bug dans le JIRA, suivez les étapes suivantes:

  1. Cliquez sur "Create a new issue" dans la barre bleue supérieure. (vous devez être connecté pour la voir) Se connecter au JIRA.)
  2. Sur la première page:
  • Choisissez le projet correspondant le mieux au bug à signaler.
    • Attention : vous devez soumettre les failles de sécurité directement à l'équipe de sécurité. Consultez l’article sur les Failles de Sécurité pour plus d’info.
  • Choisissez "Bug" dans la zone type d'issue (type de fiche)
  • Cliquez sur "Next".
  1. Sur la deuxième page:
    1. Dans summary (le titre), entrez un descriptif clair et concis du bug.
    2. Dans priority, indiquez la gravité du bug. Par exemple, un bug "Showstopper" rend le programme inutilisable alors qu'un bug typé "small" est purement esthétique. Cliquez sur l'icône d’aide (à coté de la zone) pour plus de détails.
    3. Dans components, choisissez les composants afin de délimiter le périmètre du bug. Vous pouvez choisir plusieurs composants en utilisant la touche Ctrl.
    4. Dans versions, indiquez la version affectée par le bug. Vous devez choisir les versions où le bug a pu être observé. Choisissez "First Look" uniquement si le bug ne s'applique qu’à la version First Look.
    5. Dans environnement, décrivez les caractéristiques techniques de votre système. Indiquez par exemple si vous avez remarqué qu’un bug ne se produit qu’avec un certain matériel ou certaines configurations de logiciel.
  • La meilleure façon de reporter ces informations est de reprendre celles données depuis le menu Help> About Second Life... Certains éléments pourraient être révélateurs (comme le modèle de carte graphique pour les problèmes de rendu ou le modèles de casque audio pour les problèmes de chat vocal). Si la configuration ne semble pas importante, laissez cet espace à blanc.
    • Par exemple, "Arrive seulement avec Mac OS X 10.4.1," ou "Vu seulement avec la carte NVIDIA GeForce Go 7800," etc. sont des commentaires trés intéressants
    1. Dans description, reportez une description précise du bug. Veillez à y mettre :
    • Les étapes pour correctement reproduire le bug (comment générer le bug) ou du moins une description de ce qui semble causer le bug. Essayez de faire cette description aussi simple que possible tout en étant assez précis pour permettre la reproduction du bug. Plus la méthode de reproduction sera plus simple, plus la cause du bug sera facile à déterminer.
    • Le résultat observé (ce qui arrive quand le bug se produit)
    • Le résultat attendu (ce à quoi vous vous seriez plutôt attendu)
    • Toutes choses susceptibles d'aider, comme les liens vers le forum ou les articles de blog.
    • pour rappel : soyez aussi précis et n’incluez pas de renseignements personnels!
  1. Si vous avez une Capture d'écran ou une vidéo du bug ou tout autres fichiers interessants pour l'anomalie, vous pouvez l'attacher en pièce jointe. Notez qu'il y a une limite de taille de 10 Mo par fichier. Il vous sera toujours possible d’attacher des fichiers supplémentaires plus tard. (Consultez la page Debug Help pour connaître les différentes façons de fournir de tels renseignements.)
  2. Si vous êtes un développeur et que vous joignez une patch, précisez la version source sur laquelle s’appuie votre patch et cochez l’option patch attached.
  3. Enfin, cliquez sur "Create" pour créer la nouvelle fiche.

Proposer une nouvelle fonctionnalité

Le processus est semblable à celui du signalement d’un bug avec les variantes suivantes:

  • Choisissez "New Feature" au lieu de "Bug" dans la zone type d'issue.
  • Au lieu de décrire la méthode de reproduction d’un bug, décrivez clairement l’implémentation et la fonctionnalité désirée. Assurez-vous que cette dernière n’a pas déjà été proposée. Vous pouvez également consulter notre blog pour en savoir plus sur les travaux en cours.

Signaler une faille de sécurité

  • Les failles de sécurité doivent être signalées directement à l’équipe de sécurité. (Les failles de sécurité sont des bugs permettant d’abuser des autres résidents, d’avoir des accès non autorisés aux scripts, de modifier/copier/transférer les objets des autres (les bugs de pouvoirs) et des bugs susceptibles de compromettre la grille ou la vie privées des résidents.
  • Pour plus de réactivité, vous pouvez envoyer directement le descriptif de la faille à security@lindenlab.com. Lisez cet article pour plus d'infos.

Restez poli

Note: Les CS de Second Life s'appliquent à tous les domaines de Second Life, y compris le JIRA. N'importe quel résident ne respectant pas ces directives peut se voir interdire l'utilisation du JIRA.

Exemples de conduites ou d'actions pouvant entraîner un bannissement du JIRA :

  • En utilisant le JIRA pour faire de la publicité ou promouvoir une cause, un blog, un site Internet ou tout sujet non lié au problème.
  • La provocation : par l’utilisation de message destiné à inciter la haine ou la colère ou en attaquant directement un autre résident. Ce type de comportement n’est pas adapté au JIRA. Tout message contrevenant à cette règle sera effacé.
  • Les discussions privées - Poster vos opinions personnelles ou des déclamations hors sujet est interdit. L’objectif du Jira est de trouver des solutions aux problèmes techniques. Nous apprécions les commentaires productifs. Restez dans le sujet. Les messages ne respectant par cette règle seront supprimés.
  • Guerre des éditions - Les modifications répétées relatives à la résolution, la priorité ou la classification d’une anomalie sont interdites. En cas de désaccord avec un autre résident, utilisez la partie commentaire de la fiche pour discuter de ces éléments.

Voter

Vous pouvez voter pour l’ajout de nouvelles fonctionnalités et la correction de bugs. Le tri des bugs par nombre de votes est disponible ici. Le JIRA utilise le le scrutin d'approbation, vous pouvez voter pour autant de fiches que vous voulez, mais vous êtes limité à un vote par fiche.

Les votes sont utilisés dans le processus de priorisation. La faisabilité et la durée du développement de la nouvelle fonctionnalité ou de la correction de l’anomalie entrent également en ligne de compte. Une fiche ayant reçu beaucoup de votes ne sera pas forcément résolue avant une fiche en ayant moins mais dont la correction est plus facile.

surveiller le l’état de votre fiche

Linden Lab étudie régulièrement les fiches crées sur jira.secondlife.com. L'équipe en charge de la correction est susceptible de vous demander des informations supplémentaires ou la participation de d’autres contributeurs. Revenez régulièrement sur votre fiche pour voir si cette dernière a reçu des commentaires ou des questions de Linden Lab.

Les états possibles

Voici comment le Linden Lab utilise les états de fiches :

Open
C'est une fiche assigné à un responsable. Ce dernier peut corriger l’anomalie ou la renvoyer à son émetteur en la marquant « Resolved » (voir ci dessous)
In progress
Un développeur signale qu'il travaille à la correction de l’anomalie.
Reopened
Comme l’état "Open", sauf que la fiche a été fermée puis rouverte pour signaler que le problème était toujours présent.
Resolved
C'est une état renvoyant implicitement la fiche à son émetteur. La fiche n’est pas fermée mais plutôt dans une zone de transition don l’issue dépend de sa résolution. C'est à l’émetteur de décider s'il faut rouvrir ou fermer la fiche.
Fixed
signifie que le bug est corrigé dans la version officielle de Second Life.
Fix Pending
signifie que le bug est corrigé dans une version du client prochainement disponible.
Contact Support
L'anomalie signalée doit être traitée en passant par le support. Le résident foit remplir un ticket.
Won't Finish
Signifie que le responsable de la fiche considère que la fiche ne peut et ne sera jamais corrigée.
Duplicate
Signifie qu’une autre fiche décrit déjà le même problème/fonctionnalité.
Expected Behavior
L'anomalie n'en est pas une, le fonctionnement observé est bien celui attendu.
Need more info
cette fiche manque d'informations. Vous devez la compléter si vous souhaitez que l’anomalie puisse être corrigée.
Under Advisement
L'anomalie nécessite des discussions internes à Linden Lab en plus d'une correction. Cet état permet de signaler à la communauté que la fiche a été vue et est en cours de discussion.
Cannot reproduce
L’anomalie ne peut pas être reproduite. Peut être une paramétrage ou des actions supplémentaires sont-elles requises pour reproduire l’anomalie. Complétez votre description du problème si vous souhaitez que l’anomalie puisse être corrigée. Les fiches qui ne peuvent être reproduites seront à terme fermées.
Misfield
Cette fiche n’est pas traitable dans le jira
Closed
La fiche est close.

FAQ

Consultez cette page pour trouver les réponses aux questions les plus classiques !

La recherche

Consultez cette page pour davantage d’information !

Comment aider?

vous avez bien fait de demander

Identifier les doubles

Si vous remarquez une fiche récente qui doublonne une fiche existante déjà bien documentés vous pouvez la passer à l’état "Resolved" et "Duplicate". Choisissez également "Link" et inscrivez le texte "This issue duplicates " (cette fiche doublonne la n°) et indiquez le numéro de la fiche principale. Cela permet de garder une trace de la dépendance des fiches entre eux et d’identifier les bugs les plus souvent signalés. Cela permet ainsi d’attirer l’attention sur les bugs souvent signalés et de centraliser toutes les fiches au même endroit pour s’assurer qu’il s’agit bien d’un doublon

Problème de support

Cette partie est destinée aux experts techniques capables de différencier un problème de support et un bug – la différence n’est pas toujours évidente. Vous êtes encouragé à « résoudre » ce type de fiches. Une fois une telle fiche « résolue », la responsabilité de montrer qu’il s’agit bien d’un bug affectant plusieurs résidents incombe à l’émetteur de la fiche.

Les anomalies non reproductibles

Si en faisant exactement la manipulation décrite, dans le même environnement, vous n’êtes pas capable de reproduire le bug, vous devriez « résoudre » le fiche. Soyez prudents, en cas de problème de rendu graphique, vous devez avoir la même carte vidéo. Il est préférable de laisser cette partie aux experts techniques.

Reproduction des bugs

Ce point est très important! Si vous êtes en mesure de lister étapes par étapes la marche à suivre pour reproduire le bug, faites le ! De telle description facilite le travail de Linden Lab en les aidant à se focaliser sur les bugs reproductibles. À moins un qu’un bug puisse être reproduit, il est impossible de vérifier sa correction ou non. Suivez la description de l’émetteur de la fiche et rédigez une liste des étapes à suivre pour générer le bug, ajoutez cette liste à la fiche en signalant que le bug a pu être reproduit. Les anomalies le plus largement documentées ont une plus haute priorité de correction et facilite le travail de l’équipe de tri des bugs.

Autres sources d’informations

Vous voulez en apprendre plus sur notre Traqueur d'issues?