Difference between revisions of "FR/IssueTracker"

From Apache OpenOffice Wiki
< FR
Jump to: navigation, search
(11 Voter pour une Issue)
(12 Description de la page « Issue reports »)
Line 177: Line 177:
 
* [[Fr.openoffice.org/IssueTracker/VoterIssue | Voter pour une Issue ]]
 
* [[Fr.openoffice.org/IssueTracker/VoterIssue | Voter pour une Issue ]]
  
= 12 Description de la page « Issue reports » =
+
= Créer des rapports sur les issues =
== 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
+
* [[Fr.openoffice.org/IssueTracker/RapportIssue | Créer des rapports sur les issues ]]
* http://qa.openoffice.org/issues/reports.cgi
+
 
+
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.
+
 
+
[[Image:Fr.openoffice.org_IssueZilla18.png|frame|center]]
+
+
{|border=1
+
|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 [[Fr.openoffice.org/IssueTracker/Glossaire#Issue_type ou Type  | 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 :
+
[[Image:Fr.openoffice.org_IssueZilla19.png|frame|center]]
+
 
+
Nombre d'issues par Status et par Platform :
+
[[Image:Fr.openoffice.org_IssueZilla20.png|frame|center]]
+
  
 
= 13 Glossaire des termes employés =
 
= 13 Glossaire des termes employés =

Revision as of 16:18, 28 July 2007

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


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 »

10 Création d'une issue

Voter pour une Issue

Créer des rapports sur les issues

13 Glossaire des termes employés

Autres liens pour avoir plus d'informations

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 Date Description
1.0 02/12/04 Création du document
2.0 28/07/07 Intégration dans le Wiki
Personal tools