Comment signaler une anomalie du logiciel (bogue)

Phabricator est utilisé pour rapporter les bogues du logiciel, pour demander de nouvelles fonctionnalités et pour planifier les tâches.

• Pour poser vos questions techniques concernant les projets Wikimedia, voir m:Tech
• Pour poser vos questions techniques à propos de MediaWiki sur les installations non WMF, voir le Bureau du support

Ce guide explique comment bien écrire un rapport de bogue ou demander une fonctionnalité (une tâche) dans le gestionnaire des tâches de Wikimedia (voir Phabricator pour plus d'informations). Des tâches bien documentées ont plus de chance d'être assignées rapidement. Les rapports d’anomalies doivent être rédigés en anglais. Si vous ne pouvez pas écrire en anglais, vous pouvez essayer d'utiliser un outil de traduction automatique comme Google Translate.

Conseils rapides pour les rapports

• Soyez précis
• Soyez clair : 1) expliquez comment reproduire le problème, pas à pas, sans laisser de place à l'interprétation, 2) décrivez le comportement attendu, 3) décrivez le comportement actuel. Dans des sections séparées
• Ne signalez qu'un seul bogue ou ne faites qu'une demande de fonctionnalité spécifique par tâche
• Ajoutez les liens et les exemples qui vous semblent pertinents

Avant toute chose

Pouvez-vous reproduire le problème ?

Essayez de reproduire le problème avec une version récente du logiciel, afin de voir s'il a déjà été réglé. Si le problème est sur un site comme Wikipédia, vous pouvez essayer de tester la dernière version du logiciel sur test2.wikipedia.org.

Est-ce que quelqu'un d'autre a déjà signalé le problème ?

Utilisez l'outil de recherche sur le traqueur de bogues Wikimedia pour voir si le problème a déjà été signalé ou la fonctionalité déja demandée. Vous pouvez également effectuer des recherches plus avancées sur la page de recherche avancée.

Si vous n'êtes pas sûr de savoir si un bogue a déjà été rapporté ou non, vous devez le rapporter. Il vaut mieux avoir plusieurs rapports en double du même bogue qu'un bogue non rapporté.

Il s'agit peut-être d'un problème lié à un gadget ou à un script d'utilisateur ?

Certains problèmes sont la conséquence de l'usage de programmes ou de gadgets qui ont besoin de quelques corrections. Voici un guide disponible qui décrit les étapes pour identifier un tel élément du code, que vous pourriez corriger afin de résoudre votre problème et ainsi éviter de perdre du temps à le signaler.

Est-ce un problème lié au cache ?

Certains problèmes sont relatifs à d'ancien code HTML se trouvant en cache et servi avec du nouveau JavaScript, les deux étant incompatibles. Pour aider à savoir si ceci est la cause, purgez la page, rechargez-la au niveau du navigateur, voir si le problème existe encore et inclure cette information dans le rapport de bogue.

Signaler une nouvelle anomalie (bug) ou demander une nouvelle fonctionalité

Si vous avez rencontré une anomalie dans une version récente du logiciel, et si personne d'autre ne semble l'avoir signalée, suivez la procédure suivante :

1. Aller à phabricator.wikimedia.org.
2. Vous devrez vous connecter (ou créer un compte) si vous ne l'avez pas déjà fait (voir « Créez votre compte  » ).
3. Cliquez sur le bouton du marque-pages dans le coin supérieur droit et choisissez « Rapporter un bogue logiciel » (ou « Rapporter un problème de sécurité » pour déclarer un problème de sécurité ).
4. Remplissez au moins les champs suivants :
   • Title (titre) : Une courte phrase de résumé expliquant le problème (pas votre suggestion de solution).
     • Correct : "Selecting gender is not functional on Special:Preferences"
     • Incorrect : "Software crashes"
   • Description: détails complets du problème, avec toutes les informations que vous possédez actuellement. Si cela n'est pas suffisant, on vous demandera des informations supplémentaires au fur et à mesure, en vous indiquant la manière de les obtenir. Ce champ doit inclure :
     • Pour les bogues :
       • Étapes à reproduire : la liste réduite des étapes qui font apparaitre le problème décrit. Inclure les étapes spécifiques concernant la configuration.

         Exemple :

         1. Go to https://en.wikipedia.org with Internet Explorer version 10.0;
         2. Make sure you are logged in;
         3. Select "My Preferences" menu;
         4. Go to "Gender" and select female gender from box list;
         5. Click "Save" button.

       • Résultats actuels : Ce que l'application a fait après avoir suivi ces étapes.

         Exemple :

         "There is no female gender in front of my username."

       • Résultats attendus : Ce que l'application aurait dû faire, s'il n'y avait pas eu de bogue.

         Exemple :

         "My gender is shown in front of my username."

     • Pour les demandes de nouvelles fonctionnalités :
       • Une description de ce que vous voudriez accomplir, et pourquoi. Expliquez à quelles attentes la fonctionnalité va répondre (le problème de base actuel) et joignez des exemples spécifiques ; mais ne demandez pas de solution particulière, car il pourrait y avoir autres solutions ou des solutions meilleures. Un récit utilisateur (story) est une manière efficace de représenter cela.

         Exemple :

         "As a new editor, I would like to be acknowledged for my contribution to the project, so that I feel welcomed and valued"

     • Veuillez donner également toutes les autres informations utiles comme :
       • les navigateurs web, les habillages graphiques ou les systèmes d'exploitation avec lesquels vous avez constaté le bogue ;
       • liens ou diffs vers une ou plusieurs pages où vous avez constaté le bug ; ou
       • si le problème apparaît à chaque fois ou seulement de façon occasionnelle, seulement sur certaines pages ou seulement dans des circonstances particulières.
   • Pour joindre un fichier de log ou une Screenshots (mais assurez-vous qu'aucune donnée confidentielle n'est incluse ou affichée), cliquez sur le bouton Upload File (un nuage avec une flèche) dans la barre d'outils du champ Description.
   • Sélectionnez les étiquettes (projet(s)) où vous avez trouvé le bogue :
     • Les projets sont l'endroit où les développeurs trouvent les tâches sur lesquelles ils vont travailler. Pour identifier le(s) bon(s) projet(s), utilisez la fonction Rechercher (en haut à droite) pour trouver sa description.
     • Cela peut être par exemple le projet MediaWiki-General-or-Unknown pour le logiciel wiki lui-même, ou Wikimedia-Site-Requests pour les changements de configuration sur un site de Wikimedia (voir Selecting projects ).
   • Subscribers : Si vous connaissez des utilisateurs particuliers qui voudraient recevoir les notifications concernant cette tâche, vous pouvez les ajouter ici. Dans le cas contraire, ignorez ce champ.

Vérifiez si votre rapport d'anomalie est finalisé, puis cliquez sur le bouton « Create Task ». Votre rapport sera enregistré dans la base de données et si tout va bien, quelqu'un s'en occupera bientôt. Ceci permet qu'une personne intéressée par le rapport puisse le voir et puisse potentiellement travailler dessus .

Les développeurs assigneront une priorité à la tâche quand ils planifieront de travailler dessus (voir Définir les priorités).

C'est tout ! Merci pour votre aide, vous avez contribué à améliorer MediaWiki et les projets Wikimedia.

Signaler un bogue JavaScript

Voir aussi : Aide:Trouver les scripts défectueux

Beaucoup de fonctionnalités, comme les gadgets, les scripts utilisateur, et certaines parties de MediaWiki, sont basées sur JavaScript.

Si vous rencontrez un bogue qui pourrait être lié à JavaScript, faites de votre mieux pour identifier les messages d'erreur et copiez-les dans le rapport de bug.

Il est particulièrement important de fournir toutes les informations que vous possédez, car même les administrateurs systèmes n'auront aucun accès à un quelconque rapport d'erreur.

Si le problème provient du code d'un script utilisateur ou d'un gadget, alors Phabricator n'est pas forcément l'endroit où votre problème va être pris en charge. Quelqu'un pourrait vous rediriger vers la page de discussion du script problématique (si celui-ci est identifié).

Signaler un problème de connexion

Si vous avez des difficultés pour accéder à un site Wikimedia (connexion internet trop lente, etc.) veuillez suivre https://wikitech-static.wikimedia.org/wiki/Reporting_a_connectivity_issue

Signaler un problème de session

Si vous avez des difficultés pour ouvrir une session avec votre compte, veuillez suivre Manuel:Comment déboguer/Problèmes de login .

Voir aussi

• Comment signaler des anomalies de façon efficace par Simon Tatham.
• Phabricator pour Wikimedia
  • Usages sur Phabricator
• Gestion des bogues/Cycle de vie d'un rapport de bogue
• Écrire un bon rapport de bogue ou une demande de fonctionnalité
• Rapports de bogue et demandes de fonctionalités (Wikipédia en anglais)