Outil de suivi des anomalies

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!

Portail d'Aide & Base de connaissances:

Deux choses à noter avant de commencer :

Les contributions

Toutes les contributions via le site Internet (JIRA inclus) sont gouvernées par la Contribution Agréement de Second Life. Ainsi, en y ajoutant des patchs et toutes autres informations, vous reconnaissez en avoir pris connaissance, compris et approuvé les termes.
6px

L’Utilisation

Le JIRA n'est pas destiné aux demandes de support technique, s'il vous plait n'ajoutez pas de fiches qui exigeraient une réponse personnalisée. Si vous cherchez de l'aide spécifique à votre compte, utilisez plutôt notre support.

Exemples: à traiter avec le support et non avec le JIRA:

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

6px

Le JIRA, consultable à http://jira.secondlife.com, est une base de données utilisée pour organiser les bugs et les propositions d’évolution des résidents de Second Life. C’est ici que vous pouvez documenter les problèmes que vous rencontrez dans les versions open sources ou officiel de Second Life. Cette page est destinée à vous familiariser avec le JIRA.

Plus précisément, le 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 simplement "JIRA", selon le contexte.

Son fonctionnement

Il y a deux types principaux de fiche : Les bugs et les propositions d’évolution.

Un rapport de bug est composé d'une description du problème et, si c'est possible, d’une méthode de reproduction.
Une proposition d’évolution est composée d'une description et des principes de fonctionnement de la nouvelle fonctionnalité.

Les deux types de fiches sous soumises aux autres utilisateurs, qui peuvent ajouter de nouvelles informations ou des descriptions meilleures ou simplifiées voire des cas de reproduction pour les anomalies.
Les fiches les plus populaires accumulent les votes d'autres utilisateurs.
Les programmeurs de la communauté open source peuvent y joindre « leur patchs », ou détailler les modifications à réaliser pour corriger l’anomalie.
Les votes et les réunions de tri aide à prioriser les fiches.
Les fiche approuvée par Linden Lab sont "importées" dans le JIRA privé de Linden Lab. Cela signifie que l’anomalie est étudiée et qu’un correctif est à l’étude.

Une fois la fiche importée, il est possible de connaître sont avancement au travers de son statut :

Dès que les modifications sont réalisées et en attente d’intégration dans le client, la fiche prend le statut "Fix Pending" (patch en attente).
Une fois la modification ajoutée au client, le fiche est résolue et prend le statut "Fixed" (corrigé).
Généralement, après confirmation de la correction de l’anomalie par l’équipe qualité de Linden Lab et la communauté SL, la fiche passe de "Resolved" à "Closed".

En plus des états "Fix Pending" et "Fixed", une fiche peut aussi être résolue ou fermée si elle doublonne une autre fiche, 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 détailler les étapes à suivre :

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. Chacun 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 semble a un impact limité à vous même ou à très peu de personnes, vous devriez commencer par contacter le support technique via son portail.

Restez à jour

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 !

Vérifiez que vos pilotes graphiques sont à jour. Pour les utilisateurs expérimentés, les Pilotes Omega sont des versions modifiée 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 provoquer des bugs et des frustrations en 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:

Cliquez sur "Create a new issue" dans la barre bleue supérieure. (vous devez être connecté pour la voir) Se connecter au JIRA.)
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 « security issues » pour plus d’info.
Choisissez "Bug" dans la zone type d'issue (type de fiche)
Cliquez sur "Next".

Sur la deuxième page:
1. Dans summary (le titre), entrez descriptif clair et concis du bug.
2. Dans priority, indiquez la gravité du bug. Par exemple, un bug "Showstopper" rend le programme inutilisable alors que un bug typé "small" est simplement esthétique. Cliquez 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 celle 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 également des commentaires 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 de reproduire le bug. Plus la méthode de reproduction sera plus simples, plus la cause du bug sera facile à trouver.
- Le résultat observés (ce qui arrive quand le bug se produit)
- Le résultat attendu (ce à quoi vous vous seriez plutôt attendu)
- Toute autre chose dont vous pensez que cela puisse aider, comme les liens de forum ou les articles de blog.
- pour rappel, soyez aussi précis que possible et n’incluez pas de renseignements personnels!

Si vous avez une Capture d'écran ou une vidéo du bug, ou tout autres fichiers pertinents, 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.)
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.
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 également cet article.

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 interdit 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 par ailleurs 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 dispo 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 vote 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?

Issue Tracker Forum Transcript - les Informations de Rob et Aric Linden sur les raisons de l’utilisation du Jira, les opérations réalisés en arriere plan et les réponses à différentes questions relatives au Jira.
Le guide d'utilisation du JIRA par Atlassian, créateur du JIRA.