Outil de suivi des anomalies

{| border="0" cellspacing="0" cellpadding="0" width="100%"	
{| style="width="30%"; font-size:95%; text-align:left; padding:-2px; background:none" cellpadding="0" cellspacing="0"	Contributions et utilisation	Contributions et utilisation
==Qu'est-ce que JIRA ?==
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. Les problèmes rencontrés sur les clients ou le site officiel de Second Life peuvent y être rapportés et complétés. Cette page a pour but de vous familiariser avec cet outil. Plus précisément, JIRA est un outil de gestion des anomalies édité par Atlassian et utilisé par la communauté open source de Second Life. Il est appelé JIRA Public, PJIRA, ou plus simplement JIRA.
==Les types de demande==
Il existe deux principaux types de demande : les bugs et les propositions Image:Issue Type-New Feature.gif‎‎‎.
* Un rapport de bug se compose d'une description du problème et des étapes pour le reproduire.
* Une proposition contient une description détaillant le principe de la nouvelle fonctionnalité souhaitée.
* Les demandes sont affichées aux autres utilisateurs qui peuvent les compléter et les commenter.
* Les demandes les plus populaires accumulent les votes. 
* Les développeurs de la communauté open source peuvent joindre leurs corrections ou détailler les modifications nécessaires. 
* Les votes et les réunions de tri aident à établir les demandes prioritaires. 
* Les demandes approuvées par Linden Lab sont ensuite importées dans le JIRA privé des développeurs pour être corrigées.
L'avancement d'une demande est visible par son état : dès que les modifications sont réalisées et en attente d’intégration dans le client, la demande reçoit l'état "Fix Pending" (Correction en attente). Après confirmation de la correction dans le client par l’assurance 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 est non reproductible, mal classée, incomplète ou si elle doublonne une autre demande.
==Signaler un bug ou proposer une fonctionnalité==
Remarque importante : tous les JIRA, ou "bugs" doivent être signalés en anglais. Les bugs signalés dans une autre langue ne seront pas traités par Linden Lab. 
Indiquez toujours les étapes à suivre pour reproduire le bug. Un bug ne peut être étudié que si nous sommes capables de le reproduire. Plus il se reproduit facilement, plus vite il peut être corrigé. Par exemple, au lieu de dire "Je crashe quand j'importe des fichiers", la bonne description est :
# Je clique sur Fichier > Charger une image (10L$)...
# Je choisis un fichier .TXT au lieu d'un fichier .JPG
# Je clique sur Ouvrir
# RÉSULTAT : mon ordinateur crashe sans message d'avertissement.
* Envoyez cette description à 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 ou tout autre fichier lié à votre problème. Dans l’exemple précédent, il serait utile de joindre le fichier que vous avez essayé d’importer.
* Ne décrivez qu’un seul problème par demande. Chaque bug a besoin de sa propre demande pour être suivi individuellement.
* Recherchez votre problème dans les demandes existantes avant d’en créer une pour éviter les doublons.
* Évitez d’utiliser les noms de résidents ou de donner des renseignements personnels. Si le problème n'affecte que votre avatar ou une région, commencez par contacter l'assistance technique.
===Restez à jour===
* Consultez les notes de versions pour connaître les derniers développements et les nouveaux bugs du client. Par exemple, l’interdiction de vendre un terrain pour 0L$ n'est pas un bug mais une fonction voulue par les développeurs.
* Vérifiez que les pilotes de votre carte graphique sont à jour.
===Vérifiez si le bug est déjà signalé===
Avant d'ouvrir une demande, vérifiez déjà la base de connaissance de l'Assistance et regardez si l'état de la grille signale un problème.
Éviter les doublons est très important. Leur gestion représente un important travail de tri tant pour les Lindens que pour les résidents. Il est plus efficace de concentrer le suivi d’un bug sur une demande unique et les demandes les plus actives ont souvent une plus grande priorité.
La connexion à Jira donne accès aux filtres de recherche. Vous pouvez personnaliser et enregistrer vos propres filtres ou lancer de nouvelles recherches depuis la zone de "Recherche Rapide". Cette recherche est indispensable avant toute création d'une nouvelle demande.
Si vous constatez que votre bug est déjà signalé, vous pouvez continuer à aider : 
* en laissant un commentaire avec des informations supplémentaires 
* en ajoutant une autre façon de reproduire le bug
* en votant pour la demande et montrer qu'elle est importante
===Signaler un bug===
# Connectez-vous sur Jira.
# Cliquez sur "Create a new issue" (Créer une demande) dans la barre des menus.
# Sur la première page :
#* Choisissez le projet correspondant le mieux au bug à signaler. Attention : les failles de sécurité doivent êtres soumises directement à l'équipe de sécurité (voir Failles de Sécurité).
#* Choisissez "Bug" (Bogue) dans la zone Issue type (Type de demande).
#* Cliquez sur "Next" (Suivant).
# Sur la deuxième page:
#* Dans Summary (Résumé), entrez un descriptif clair et concis du bug.
#* Dans Priority (Priorité), indiquez la gravité du bug. Par exemple, un bug "Showstopper" rend le programme inutilisable. Cliquez sur l'icône d’aide pour plus de détails.
#* Dans Components (Composants), choisissez les composants affectés par le bug. Vous pouvez choisir plusieurs composants avec la touche Ctrl.
#* Dans Versions, précisez la version affectée. 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.
#* Dans Environment (Environnement), reportez la configuration de votre système. Indiquez par exemple si le bug ne se produit qu’avec un certain matériel ou une certaine configuration logiciel. Par exemple, "Uniquement sur Mac OS X 10.4.1" ou "Vu seulement avec la carte NVIDIA GeForce Go 7800" sont des commentaires intéressants. La meilleure façon de connaître votre configuration est de reprendre celle donnée depuis le menu Aide > À propos de Second Life... Certains éléments peuvent être révélateurs comme le modèle de carte graphique pour les problèmes de rendu ou le modèle de casque audio pour les problèmes de chat vocal. Si la configuration importe peu, laissez cet espace vide.
#* Dans Description, donnez une description du bug avec :
#** Les étapes pour reproduire correctement le bug ou du moins une description de sa cause. Essayez de donner une description simple mais précise pour permettre la reproduction du bug. Plus la reproduction sera plus simple, plus la cause du bug sera facile à trouver.
#** Le résultat observé (ce qui arrive quand le bug se produit).
#** Le résultat attendu (ce qui aurait du se produire).
#** Tous les éléments susceptibles d'aider, comme les liens vers le forum ou les articles de blog.
#** Ne donnez pas de renseignements personnels !
# Si vous avez une capture d'écran ou une vidéo ou tout autre fichier concernant le bug, vous pouvez l'attacher en pièce jointe (limite de taille de 10 Mo par fichier). Il vous sera toujours possible d’attacher des fichiers supplémentaires plus tard. Lisez la page Debug Help pour connaître les différentes façons d'obtenir de tels renseignements.
# Si vous désirez joindre une correction, précisez la version source sur laquelle s’appuie votre correction et cochez Patch attached.
# Enfin, cliquez sur "Create" (Créer) pour publier la nouvelle demande.
===Proposer une nouvelle fonctionnalité===
Le processus est semblable au signalement d’un bug avec quelques différences :
* Choisissez "New Feature" (Nouvelle fonctionnalité) dans la zone Issue type (Type de demande).
* Dans la description, décrivez clairement la fonctionnalité désirée. Assurez-vous que cette dernière n’a pas déjà été proposée. Vous pouvez aussi consulter notre blog pour en savoir plus sur nos projets en cours.
===Signaler une faille de sécurité===
Les failles de sécurité sont des bugs permettant d’abuser des autres résidents ou de compromettre la grille ou la vie privée des résidents. Elles doivent être signalées directement à l’équipe de sécurité. Pour plus de réactivité, vous pouvez envoyer le descriptif de la faille à cet e-mail. Plus d'informations sont disponibles sur la page dédiée aux Failles de Sécurité.
==Restez poli==
Les règles de communauté de Second Life s'appliquent à tous les domaines de Second Life, y compris JIRA. Un résident ne respectant pas ces règles peut se voir interdire l'accès à JIRA. Exemples de comportements pouvant entraîner un bannissement de JIRA :
* Utiliser JIRA pour faire de la publicité ou promouvoir une cause, un blog, un site Internet ou tout autre sujet non lié au problème.
* Envoyer des message incitant à la haine ou attaquant un autre résident. Ce type de message sera effacé.
* Utiliser JIRA pour des discussions privées. Poster des opinions personnelles hors sujet est interdit. L’objectif du Jira est de trouver des solutions aux problèmes techniques et nous apprécions les commentaires productifs.
* Faire des guerre d'édition. Les modifications répétées sur la résolution, la priorité ou la classification d’une demande sont interdites. Utilisez les commentaires de la demande pour discuter en cas de désaccord avec un autre résident.
==Votez==
JIRA utilise le vote par approbation : vous pouvez voter pour autant de demandes que vous voulez, mais vous êtes limité à un vote par demande. Les votes sont utilisés pour établir les priorités. La faisabilité et la durée de développement de la nouvelle fonctionnalité ou de la correction du bug sont également prises en compte. Une demande avec beaucoup de votes ne sera pas forcément résolue avant une demande en ayant moins mais dont la correction est plus facile.
==Surveillez l’état de votre demande==
Les développeurs consultent les demandes et sont donc susceptibles de vous demander des informations supplémentaires. Relisez régulièrement votre demande pour voir si des commentaires ou des questions ont été rajoutés.
Image:Status-Open.gif‎ Open (Ouverte) : demande ouverte.
Image:Status-In_Progress.gif‎‎‎ In progress (En cours) : un développeur travaille au traitement de la demande.
Image:Status-Reopened.gif‎‎‎ Reopened (Rouverte) : la demande a été fermée puis rouverte pour signaler que le problème était toujours présent.
Image:Status-Resolved.gif‎‎‎ Resolved (Traitée) : un traitement a été effectué, la demande reçoit une résolution :
:: Fixed (Corrigé) : le bug est corrigé dans la version officielle de Second Life.
:: Fix Pending : le bug est corrigé dans une prochaine version.
:: Contact Support : le problème doit être traitée en passant par l'Assistance.
:: Won't Finish : la demande ne peut pas être corrigée.
:: Duplicate (Doublon) : une autre demande décrit déjà le même bug ou fonctionnalité.
:: Expected Behavior : le fonctionnement observé est bien celui attendu.
:: Need more info : la demande manque d'informations et doit être complétée.
:: Under Advisement : la demande nécessite des discussions internes à Linden Lab en plus d'une correction.
:: Cannot reproduce : le bug ne peut pas être reproduit. Complétez la description si des étapes supplémentaires sont nécessaires.
:: Misfield : la demande n’est pas traitable sur Jira.
 Closed (Fermée) : la demande est close.
==Comment aider sur JIRA ?==
===Identifier les doublons===
Si une demande récente doublonne une autre demande mieux documentée, vous pouvez la traiter à l’état "Resolved" (Traitée) avec la résolution "Duplicate" (Doublon). Liez les deux demandes par le bouton "Link" (Lier) puis "This issue duplicates" (Cette demande doublonne) et indiquez la clé de la demande principale. Cela permet ainsi d’identifier les bugs souvent signalés et de centraliser toutes les demandes au même endroit.
===Identifier les problèmes d'assistance===
Cette partie est destinée aux personnes capables de différencier un problème d'assistance d'un bug. La différence n’est pas toujours évidente mais vous êtes encouragé à traiter ce type de demandes. La responsabilité de prouver qu’il s’agit bien d’un bug affectant plusieurs résidents incombe au rapporteur de la demande.
===Reproduire les bugs===
Si vous n’êtes pas capable de reproduire le bug en faisant exactement la manipulation décrite dans le même environnement, vous pouvez traiter la demande. Soyez prudents : vous devez avoir la même carte vidéo si la demande concerne un bug graphique. Il est préférable de laisser cette partie aux développeurs.
Si vous êtes capable de lister étape par étape la marche à suivre pour reproduire un bug, faites-le ! Complétez la description du rapporteur en ajoutant la liste des étapes. Cela facilite le travail des développeurs en les aidant à se focaliser sur les bugs reproductibles.
==FAQ==
Consultez cette page pour trouver les réponses aux questions les plus fréquentes.
==Rechercher sur JIRA==
Consultez cette page pour plus d’information sur la recherche dans JIRA.
==Autres informations==
* Issue Tracker Forum Transcript : informations de Rob et Aric Linden sur l’utilisation de Jira et les opérations réalisées en arrière-plan. 
* Le guide d'utilisation de JIRA par Atlassian, créateur de JIRA.
<videoflash>Jofq8ClPfNg</videoflash>
Category: Issue Tracker/fr