Comment signaler une anomalie du logiciel (bogue)

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page How to report a bug and the translation is 100% complete.
Other languages:
Bahasa Indonesia • ‎Bahasa Melayu • ‎Cymraeg • ‎Deutsch • ‎English • ‎Esperanto • ‎Hawaiʻi • ‎Interlingue • ‎Lëtzebuergesch • ‎Napulitano • ‎Nederlands • ‎Ripoarisch • ‎Scots • ‎Taqbaylit • ‎Tiếng Việt • ‎Türkçe • ‎aragonés • ‎asturianu • ‎català • ‎dansk • ‎español • ‎français • ‎galego • ‎hrvatski • ‎interlingua • ‎italiano • ‎lietuvių • ‎magyar • ‎norsk bokmål • ‎occitan • ‎polski • ‎português • ‎português do Brasil • ‎română • ‎shqip • ‎sicilianu • ‎slovenčina • ‎suomi • ‎svenska • ‎čeština • ‎Ελληνικά • ‎беларуская (тарашкевіца)‎ • ‎български • ‎русский • ‎српски / srpski • ‎українська • ‎ייִדיש • ‎עברית • ‎ئۇيغۇرچە • ‎العربية • ‎تۆرکجه • ‎سنڌي • ‎فارسی • ‎پښتو • ‎मराठी • ‎हिन्दी • ‎ਪੰਜਾਬੀ • ‎தமிழ் • ‎తెలుగు • ‎ಕನ್ನಡ • ‎සිංහල • ‎ไทย • ‎ქართული • ‎中文 • ‎日本語 • ‎ꯃꯤꯇꯩ ꯂꯣꯟ • ‎한국어
Raccourci : BUGREPORT

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 : expliquez comment reproduire le problème, pas à pas, de telle façon que d'autres personnes puissent également le reproduire ou comprendre votre demande.
  • Ne signalez qu'un seul problème par tâche
  • Ajoutez tout lien ou exemple qui vous semble pertinent

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é.

Avez-vous essayé de résoudre le problème par vous-même ?

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.

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 fait (voir « Créez votre compte  » ).
  3. Cliquez sur le bouton du marque-pages dans le coin supérieur droit et choisissez « Créer la tâche » (ou « Rapporter des problèmes 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."
      • Incorrect : "Software crashes."
    • Assigned to (assigné à) : vous devez ignorer ce champ. Les développeurs le rempliront quand ils prévoiront de travailler sur la tâche.
    • Description: toutes les informations sur le problème, en donnant autant de détails que possible. Il peut s'agir de :
      • 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 user name."
        • 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 user name."
      • 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 n'est 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 également l'aide sur comment trouver les erreurs de scripts

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.[1] 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 à accéder à un site Wikimedia à cause, par exemple, d'une connexion à internet trop lente, veuillez voir la page Signaler un problème de connexion (en anglais).

Signaler un problème de session

Si vous avez des difficultés pour ouvrir une session avec votre compte, veuillez suivre Comment déboguer/problèmes de connexion (en anglais).

Notes

Voir aussi