Difference between revisions of "FR/IssueTracker"

From Apache OpenOffice Wiki
< FR
Jump to: navigation, search
(Comment lire ce document)
(6.3 Créer une issue)
Line 113: Line 113:
  
 
Au chapitre 10 - Création d'une issue , vous trouverez des explications pour vous aider à créer une issue.
 
Au chapitre 10 - Création d'une issue , vous trouverez des explications pour vous aider à créer une issue.
 
  
 
== 6.4 Voter pour une issue ==
 
== 6.4 Voter pour une issue ==

Revision as of 15:50, 28 July 2007

Fichier d'origine en cours de transfert dans ce Wiki :


Contents

But de ce document

OpenOffice.org appartient à ses utilisateurs. Ils ont la possibilité d'influer sur son développement et de reporter les points qui pourraient les pénaliser dans leur utilisation quotidienne.

Le but de ce document est d'expliquer comment chaque utilisateur d'OpenOffice.org peut signaler un dysfonctionnement ou faire une demande d'amélioration. Le projet OpenOffice.org a besoin de ces informations pour évoluer dans le bon sens et c'est un moyen très facile de contribuer.

Pour cela, le projet OpenOffice.org utilise le système IssueZilla (IZ pour les intimes) permettant de recenser et d'organiser les différentes demandes appelées des issues. IssueZilla est également dénommé plus rarement IssueTracker (IT)

Ce document tentera d'expliquer comment utiliser IssueZilla pour rechercher parmi les milliers d'issues existantes si la demande a déjà été faite et pour en créer une nouvelle si nécessaire.

Tout le développement d'OpenOffice.org est basé sur ce système et donc chaque petit grain de sable apporté par les utilisateurs peut faire évoluer le développement d'OpenOffice.org.

Pré-requis

Pour utiliser IssueZilla, il faut d'abord se créer un compte sur OpenOffice.org :

Il est également conseillé (mais pas obligatoire) de rejoindre le projet francophone :

  • La procédure est expliquée dans les chapitres suivants.

Il est recommandé d'avoir un minimum de notions en anglais pour arriver à se repérer dans le système IssueZilla.

Pour créer une issue, il faut qu'elle soit correctement rédigée en anglais (c'est la langue de travail d'OpenOffice.org). Pour cela, vous pouvez vous faire assister par des personnes de la liste [dev-fr]

Comment lire ce document

Pour lire ce document, il est souvent nécessaire de consulter le glossaire à l'aide des liens hypertextes insérés dans les différents chapitres.

Comment se créer un compte sur OpenOffice.org

Pour commencer, il faut :

  • Se connecter sur le site d'OpenOffice.org : http://fr.openoffice.org
  • Cliquer sur « register » en haut à droite pour aller sur http://www.openoffice.org/servlets/Join
  • Saisir un nom de login et un email
  • Cliquer sur « register »
  • Attendre la réception de 2 mails en provenance de SourceCast
  • Le premier « Welcome to openoffice.org » donne une description en anglais.
  • Le deuxième « How to set your openoffice.org password » donne un lien du genre :
  • Ce lien mène à une page sur laquelle il faut saisir 2 fois le mot de passe que vous voulez utiliser.
  • Valider le mot de passe, en cliquant sur « Change password ».
  • Après validation du mot de passe, le nom du login doit apparaître en haut à droite .

Comment rejoindre le projet Francophone

  • Se connecter sur le site http://fr.openoffice.org
  • Cliquer sur « MemberShips » dans la barre verticale de gauche.
  • Cliquer sur le lien « Request project role » en haut de la page.
  • Cliquer sur le bouton « Submit request » pour rejoindre le projet en tant que « Observer »
  • Le statut Observer, est le statut minimum pour participer au développement du projet.

Une fois le compte créé et configuré, pour se connecter, il faudra :

  • Se connecter sur le site http://fr.openoffice.org
  • Renseigner les champs « user » et « password » en haut à droite de la page et cliquer sur le bouton « Login ».

A partir de là, il est possible de participer activement au développement du projet :

  • En cliquant sur « My issues » dans le menu vertical de gauche, il est possible de voter pour des issues ou de créer une nouvelle issue.
  • En cliquant sur le projet « fr », il est possible de retourner sur la page d'accueil standard et de cliquer ensuite sur "Documents & Files" pour mettre ou consulter des documents en ligne.

Il est possible également de faire beaucoup d'autres choses, car SourceCast est un système complexe.

Présentation rapide du système IssueZilla

Le système IssueZilla permet de centraliser et de gérer toutes les demandes d'améliorations et toutes les demandes de corrections de dysfonctionnements en provenance du monde entier.

Chaque demande est appelée une issue.

Tous les utilisateurs d'OpenOffice.org peuvent créer des issues dans le système IssueZilla.

Une fois l'issue créée, le système permet de la gérer et de suivre son évolution jusqu'à sa résolution ou son abandon.

Avant d'être résolue ou abandonnée, une issue passe par plusieurs phases et entre les mains de plusieurs personnes, d'où la nécessité de disposer d'un système de gestion.

Pour information, il y a actuellement 37200 Issues dans le système créé en Octobre 2000. Depuis cette date, 30000 ont été fermées ou résolues et environ 7000 sont en attente ou en cours de traitement.

La gestion d'IssueZilla est actuellement assurée par l'équipe QA Team. Cette équipe est à ce jour composée de 7 personnes bénévoles, mais n'importe qui peut se porter volontaire pour les assister.

6.1 Recherche d'une issue (Query)

Avant de créer une nouvelle issue, il est important de vérifier qu'une demande similaire n'a pas déjà été faite en effectuant des recherches dans les issues existantes afin de ne pas créer une surcharge de travail inutile aux personnes qui les analysent

Il existe un outil permettant de faire des recherches (Query) en fonction de nombreux critères.

Ce système est très complet et complexe. Son utilisation sera détaillée dans les chapitres suivants.

Il est donc important d'apprendre à maîtriser cet outil avant de créer votre première issue.

Au chapitre 9 - Recherche d'Issues avec l'outil « Issue tracking query » , vous trouverez quelques explications complémentaires pour rechercher des issues.

6.2 Rapport sur les issues existantes

Étant donné qu'il y a actuellement dans le système IssueZilla environ 37000 issues, un outil permet de demander des rapports (Statistiques) sur les issues créées.

Par exemple, il est possible de connaître :

  • Le nombre d'issues par composant et par priorité.
  • Le nombre d'issues par version et par résolution.

Au chapitre 12 - Description de la page « Issue reports » , vous trouverez quelques explications sur l'utilisation des rapports.

6.3 Créer une issue

Si votre issue n'a pas encore été créée par une autre personne, vous pouvez la proposer.

Il est important de respecter plusieurs points pour que votre issue soit validée.

Plus votre issue sera explicite, plus vous aurez de chances qu'elle soit prise en compte.

Au chapitre 10 - Création d'une issue , vous trouverez des explications pour vous aider à créer une issue.

6.4 Voter pour une issue

Une fois que l'issue est créée, il est possible de voter et surtout d'appeler d'autres personnes à venir voter pour votre issue.

Plus il y aura de votes, plus il y aura de chance que l'issue soit prise en compte rapidement.

Pour appeler d'autres personnes à venir voter sur vos issues, il faut utiliser la liste [dev-fr] ou les listes anglophones.

Au chapitre 11 - Voter pour une issue , vous trouverez quelques indications pour voter pour une Issue.

6.5 Compléter une issue

Vous pouvez, après identification, compléter une issue (même si vous n'en êtes pas l'auteur) afin d'apporter des précisions. Par exemple, si un problème est reporté pour un système d'exploitation et que cela marche ou ne marche pas chez vous, avec un autre système, cela pourra donner une piste à la personne en charge de la résolution du problème.

Attention, une issue n'est pas une liste de discussion : ne donner que l'information nécessaire afin de ne pas la noyer dans un flot difficile à trier ensuite.

6.6 Suivre une issue

Vous pouvez vous abonner aux modifications d'une issue (champ CC) afin de recevoir un mail automatique à chaque changement de celle-ci.

Organigramme simplifié du cheminement d'une Issue

Vous trouverez ci-dessous un exemple très simplifié du cheminement d'une issue.

Fr.openoffice.org IssueZilla01.gif

IssueZilla et OpenOffice.org en quelques chiffres

Voici quelques chiffres qui donnent une idée de la taille de ce projet :

  • La première Issue du système (la n° 13) a été créée en Octobre 2000.
  • Il y a actuellement 37000 issues dans IssueZilla dont 7000 sont encore ouvertes.
  • 3000 personnes différentes ont entré ces 7000 issues encore ouvertes.
  • Le système IssueZilla est géré par sept personnes (les membres du QA Team), toutes bénévoles.
  • Il y a plusieurs centaines (milliers ?) de bénévoles qui travaillent occasionnellement (ou intensément) sur le projet OpenOffice.org dans son ensemble.
  • Il y a environ 100 personnes chez Sun, 20 chez Novell et quelques dizaines d'autres dans diverses sociétés qui travaillent à titre professionnel sur OpenOffice.org.
  • Il y a 20 développeurs sur Writer, 5 sur Calc et quelques uns sur les autres modules qui travaillent sur le code source en C++ à plein temps.

D'après ces chiffres, vous comprenez mieux pourquoi OpenOffice.org manque de développeurs et pourquoi il faudra être indulgent si votre issue n'est pas prise en compte rapidement.

En fonction de nombreux paramètres, elle pourra être prise en compte en quelques semaines ou après plusieurs années ou peut-être même jamais...

Donc, si vous êtes développeur n'hésitez pas à venir apporter votre contribution pour faire avancer le projet OpenOffice.org.

Une nouvelle liste francophone (labo@fr.openoffice.org) a d'ailleurs été créée dans le but d'apprendre à compiler OpenOffice.org. Il sera ainsi éventuellement possible par la suite de proposer des Patchs :

Chacun peut également contribuer au projet sous de multiples formes : traduction, rédaction de documentations, etc.

N'hésitez pas à venir nous rejoindre sur nos listes de travail :

Recherche d'Issues avec l'outil « Issue tracking query »

9.1 Comment accéder au Query

Pour accéder au Query depuis le site http://fr.openoffice.org/ , il faut d'abord se connecter en saisissant son login et son mot de passe ( password) en haut à droite de la page.

Ensuite, depuis l'onglet « My Pages », cliquez sur le lien « Find Issues » dans le menu à gauche.

Le Query est également accessible sur cette page :

9.2 Présentation rapide du Query

Cet outil permet d'effectuer des recherches dans les issues existantes, afin de savoir par exemple si votre issue n'a pas déjà été créée par une autre personne.

Pour rechercher si une issue existe déjà, il est souvent nécessaire de lancer plusieurs recherches en essayant plusieurs mots clés ou des synonymes. Il faut commencer par une recherche assez générale et la restreindre de plus en plus en fonction du nombre d'issues retournées.

Il est également possible de retrouver une issue suivant de nombreux critères. Il faut donc essayer plusieurs méthodes pour être sûr d'avoir bien cherché.

Les chapitres suivants présentent les différentes zones de cet outil de recherche.

9.3 Description de la page « Issue tracking query » Partie 1/9

Le menu indiqué dans la partie supérieure de l'écran comporte les liens suivants :

Fr.openoffice.org IssueZilla02.png
  • New : Permet de créer une nouvelle issue
  • Query : Cet écran
  • Reports : Permet de créer des rapports de statistiques
  • My votes : Permet de consulter vos votes sur les issues
  • My issues : Donne la liste de vos issues
  • Edit Prefs : Permet de modifier vos préférences

9.4 Description de la page « Issue tracking query » Partie 2/9

Fr.openoffice.org IssueZilla03.png

Dans chaque liste, il est possible de ne sélectionner aucun champ, un seul champ ou plusieurs champs. Pour sélectionner plusieurs champs, il faut utiliser la touche CTRL.

Dans le cas où aucun champ n'est sélectionné, le système considère qu'ils sont tous sélectionnés.

Si le résultat de votre votre sélection contient plus de 16300 issues, la liste des issues ne sera pas affichée (Pour information, il y a actuellement environ 37000 issues dans le système).

Pour comprendre les différents choix de chaque liste, reportez-vous au glossaire grâce aux liens ci-dessous :

9.5 Description de la page « Issue tracking query » Partie 3/9

Fr.openoffice.org IssueZilla04.png

Cette partie permet de faire une recherche sur les différentes personnes affectées à une issue.

Pour des explications sur les différents choix, reportez-vous au glossaire grâce aux liens ci-dessous :

9.6 Description de la page « Issue tracking query » Partie 4/9

Fr.openoffice.org IssueZilla05.png

Cette partie permet de rechercher une issue par son numéro :

9.7 Description de la page « Issue tracking query » Partie 5/9

Fr.openoffice.org IssueZilla06.png

Cette partie permet de rechercher une issue sur sa date de dernière modification ou sur son nombre de votes.

9.8 Description de la page « Issue tracking query » Partie 6/9

Fr.openoffice.org IssueZilla07.png

Cette partie permet de rechercher une issue également sur sa date mais d'une façon plus précise.

9.9 Description de la page « Issue tracking query » Partie 7/9

Fr.openoffice.org IssueZilla08.png

Cette partie permet de rechercher une issue selon :

9.10 Description de la page « Issue tracking query » Partie 8/9

Fr.openoffice.org IssueZilla09.png

Cette partie est la moins visible de la page, mais c'est la plus complète (et complexe) et donc certainement la plus puissante.

Il est par conséquent possible de lancer des recherches sur n'importe quelle partie de l'issue et d'indiquer comment la recherche doit s'effectuer. On peut ensuite ajouter d'autres critères avec une clause « Or » ou une clause « And »

9.11 Description de la page « Issue tracking query » Partie 9/9

Fr.openoffice.org IssueZilla10.png

Cette partie permet d'enregistrer le Query ou de le définir par défaut.

Elle permet aussi d'indiquer l'ordre de tri pour l'affichage de la liste des issues. Elle vous permet également de mémoriser une recherche et de la rappeler par un nom.

Et pour finir, le bouton « Submit query » permet d'exécuter le Query et d'afficher la liste des issues sélectionnées (cf chapitre suivant).

Le bouton « Submit query » figure également dans la partie supérieure de l'écran. Il est possible d'utiliser l'un ou l'autre indifféremment.

9.12 Exemple de résultat du Query (Issue list )

Cette page donne la liste des issues en fonction des critères de sélection indiqués sur l'écran précédent.

Fr.openoffice.org IssueZilla11.png

Cliquez sur les liens ci-dessous pour avoir la traduction et la description du glossaire :

En bas de la page des résultats, le lien « Change columns » permet de changer les colonnes affichées (cf chapitre suivant)

9.13 Description de la page « Change columns »

Voici les colonnes, qu'il est possible de sélectionner pour le rapport.

Pour avoir une description, cliquez sur le lien qui vous mènera au glossaire : Opendate , Changedate , Issue_type ou Type , Priority , Platform ou plt , Owner , Reporter , Status , Resolution ou Result , Subcomponent , Component , Version , OS , Votes , Target_milestone , Qa_contact , Status_whiteboard , Blocks , Dependson , Keywords , Summary , Summaryfull

10 Création d'une issue

10.1 Comment accéder à la création des issues

Pour y accéder depuis le site http://fr.openoffice.org/ , il faut d'abord se connecter en saisissant son login et son password en haut à droite de la page.

Ensuite, depuis l'onglet « My Pages », cliquez sur le lien « My Issues » dans le menu à gauche et ensuite sur le lien « New » en haut de la page.

Cet outil est également accessible sur cette page :

10.2 Présentation rapide

Nous arrivons au principal but de ce document : Comment créer des issues pour faire remonter des bugs ou pour faire des demandes d'améliorations.

Important : Commencez toujours par vérifier soigneusement que votre issue n'a pas déjà été créée par quelqu'un d'autre. Cette précaution évitera une charge de travail supplémentaire aux bénévoles du QA Team, qui je le rappelle ne sont pas très nombreux et ne font pas que cela.

De plus, la création d'une issue ne signifie pas que celle-ci sera prise en compte et résolue rapidement, car il faut savoir également qu'OpenOffice.org manque cruellement de développeurs et il n'est pas toujours possible de traiter toutes les demandes rapidement. Soyez donc très patients après la création d'une issue.

Pour finir, ce n'est pas parce que votre issue ne sera pas traitée rapidement, qu'il ne faut pas créer d'issue car tout le développement d'OpenOffice.org est basé sur ce système.

Chaque petit grain de sable apporté par les utilisateurs peut faire évoluer le développement d'OpenOffice.org.

Avant de créer un rapport de bug, vous devez également vous assurer que ce bug est reproductible sur d'autres ordinateurs. Pour cela, il est fortement conseillé d'utiliser la liste [dev-fr] pour demander à d'autres personnes de tester votre bug.

Enfin, avant de remplir une demande d'amélioration vous devez vérifier que ce que vous demandez n'est pas déjà réalisable avec OpenOffice.org. Pour cela posez la question sur la liste [user-fr] ou sur la liste [dev-fr]

Pour vous abonner à ces listes, consultez la page :


10.3 Création d'une issue (1/3)

La première chose à sélectionner est le composant concerné (Calc, Writer,...)

Fr.openoffice.org IssueZilla12.png

Pour plus d'explications sur ce champ regardez les commentaires dans le glossaire :

  • Component

Choisissez bien le composant, ce n'est pas parce que vous rencontrez un problème sur une version française que le composant est fr, même s'il s'agit du dictionnaire. Le composant fr est uniquement réservé aux problèmes sur le site francophone ou au travail du projet francophone.

10.4 Création d'une issue (2/3)

Ensuite, il faut renseigner les champs ci-dessous :

Fr.openoffice.org IssueZilla13.png

Pour avoir des explications sur les différents champs, ne pas hésiter à cliquer sur les liens qui vous amèneront dans le glossaire à la fin de ce document. Soyez précis lorsque vous remplissez le sommaire, c'est ce qui permet de synthétiser le problème rencontré et permet ensuite de filtrer l'importance, l'urgence, la pertinence, etc...

  • Reporter , Component , Found in Version , Subcomponent , Platform ou plt , OS , Priority , Issue_type , Assigned to , CC , URL , Summary , Description

10.5 Création d'une issue (3/3)

Fr.openoffice.org IssueZilla14.png

Cette partie permet d'indiquer la description de l'issue. Pour cette description, il est important :

  • D'être le plus compréhensible possible pour que les membres du QA Team puissent classer votre issue rapidement. Le message doit être en anglais. Rester factuels et synthétique
  • Que votre problème soit reproductible facilement en fournissant par exemple un fichier en pièce jointe.

Il est possible d'ajouter des liens hypertextes vers d'autres issues ou ailleurs sur Internet simplement en saisissant l'adresse complète. Exemple :

10.6 Validation de la création

Pour valider la création de l'issue, il faut cliquer sur le bouton « Submit Issue »

L'écran suivant indique que l'issue à été postée (ex : Issue 37768 posted )

Fr.openoffice.org IssueZilla15.png

Sur cet écran, en cliquant sur le lien « Attach a file to this issue », il est possible d'ajouter une pièce jointe à l'issue pour donner un complément d'information ou un exemple de fichier.

Pour finir, vous allez recevoir un message en anglais dont le sujet reprend le numéro de votre issue et la description de celle-ci (ex : [Issue 37768]New - Essai création issue).

À chaque modification de votre issue, vous recevrez également un message.

Il est aussi possible d'être informé des modifications d'une autre issue, en renseignant le champ « Add CC » de celle ci.

10.7 Ajout d'une pièce jointe

Si vous avez cliqué sur le lien « Attach a file to this issue », vous arriverez sur l'écran ci-dessous :

Fr.openoffice.org IssueZilla16.png

Sur celui-ci, il faut aller rechercher un fichier sur votre disque dur avec le bouton parcourir.

Attention : Il est fortement conseillé d'utiliser des noms de fichiers sans espace et sans caractère spécial. Ne pas mettre des fichiers volumineux surtout si vous avez une connexion à bas débit.

Ensuite, il faut indiquer une description pour ce fichier et sélectionner correctement le type de fichier dans la liste.


Pour finir, il faut cliquer sur le bouton « Submit » en bas de la page pour ajouter votre fichier à l'issue.

11 Voter pour une Issue

11.1 Présentation rapide

Une fois que l'issue est créée, il est possible de voter et surtout d'appeler d'autres personnes à venir voter pour celle-ci.

Plus il y aura de votes et plus il y aura de chances, mais pas de certitudes :-), que l'issue soit résolue rapidement.

Pour appeler d'autres personnes à venir voter pour vos issues, il faut utiliser la liste [dev-fr] ou les listes anglophones.


11.2 Comment voter pour une issue

Pour y accéder depuis le site http://fr.openoffice.org/ , il faut d'abord se connecter en saisissant son login et son password en haut à droite de la page.

Pour voter pour une issue, il faut afficher le détail de l'issue en utilisant la méthode de votre choix (Accès direct par son numéro ou recherche avec l'outil de Query).

Au milieu de l'écran, vous trouverez un lien « Vote for this issue », qui vous amènera sur l'écran qui récapitule tous vos votes.

Fr.openoffice.org IssueZilla17.png

Sur cet écran, vous retrouverez pour chaque composant (component), la liste des issues pour lesquelles vous avez voté.

Il faut savoir qu'il est possible de mettre au maximum 2 points sur une issue avec un total maximum de 5 points par composant (component).

Il est possible de modifier ces votes à tout moment et de reporter des points d'une issue sur l'autre en fonction de vos priorités.

12 Description de la page « Issue reports »

12.1 Présentation de l'écran

Pour accéder à cet écran, il faut cliquer sur le lien « Reports » en haut de la page du Query ou directement à cette adresse

Cet outil est très intéressant et très instructif. Il permet d'obtenir des statistiques sur les issues. Par exemple, il est possible de connaître :

  • Le nombre d'issues par composant et par priorité, le nombre d'issues par version et par résolution, le nombre d'issues par statut, etc.
Fr.openoffice.org IssueZilla18.png
Champ Description
View Permet de faire un présélection sur les issues à analyser ( All Issues, Open Issues,...)
Show links to individual issues Permet d'afficher dans chaque cellule du résultat la liste des issues et pas seulement le nombre total.
Type Type de l'issue. Cf Issue_type ou Type
Containing Indiquer un ou plusieurs mots contenus dans les issues que vous recherchez.
Rows Permet de déterminer le titre des colonnes
Columns Permet de déterminer le titre des lignes. À l'intersection de chaque ligne et de chaque colonne, le nombre d'issues correspondantes sera indiqué

12.2 Exemples de résultats

Nombre d'issues par priorité en colonne et par composant en ligne :

Fr.openoffice.org IssueZilla19.png

Nombre d'issues par Status et par Platform :

Fr.openoffice.org IssueZilla20.png

13 Glossaire des termes employés

14 Autres liens pour avoir plus d'informations

14.1 Liens francophones

14.2 Liens anglophones

Guide pour utiliser IssueZilla :

Documentation :

Liste des projets :

Le traitement d'une issue entre QA et Dev :

Des liens de raccourcis pour faire des recherches sur IZ :

Pour les demandes d'améliorations :

Pour aider le projet QA :

15 Conclusion

J'espère que ce document vous aura apporté quelques informations.

J'espère aussi qu'il pourra vous aider à créer votre propre issue ou simplement vous aider à vérifier si votre problème est déjà signalé dans IssueZilla.

Si vous voulez apporter des compléments d'informations à ce document ou si vous y avez trouvé des erreurs, n'hésitez pas à me le signaler.

Il ne faut pas hésiter non plus à venir nous rejoindre sur nos listes de travail (dev-fr, doc-fr, dic..) pour apporter votre contribution, aussi minime soit-elle.

Pour finir et pour vous remercier de m'avoir lu jusque là :-), voici deux astuces pour afficher deux écrans cachés (easter-eggs) dans Writer et dans Calc (Merci Sophie) :

  • Dans Writer, écrire « StarWriterTeam » et appuyer sur F3
  • Dans Calc, saisir la formule « =STARCALCTEAM() »

16 Crédits

Auteur : Tony GALMICHE

Remerciements :

  • Sophie pour ses nombreuses réponses et traductions.
  • Alex pour ses traductions.
  • Clément, Corentin, François, Jean-François et Laurent pour leurs corrections et commentaires.

Version : 1.0 du 02/12/04 - Création du document

Personal tools