Comment signaler une anomalie du logiciel (bug)

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 • ‎Kreyòl ayisyen • ‎Lëtzebuergesch • ‎Napulitano • ‎Nederlands • ‎Ripoarisch • ‎Scots • ‎Taqbaylit • ‎Tiếng Việt • ‎Türkçe • ‎aragonés • ‎asturianu • ‎català • ‎dansk • ‎español • ‎euskara • ‎français • ‎galego • ‎hrvatski • ‎interlingua • ‎italiano • ‎kurdî • ‎lietuvių • ‎magyar • ‎norsk bokmål • ‎occitan • ‎polski • ‎português • ‎português do Brasil • ‎română • ‎shqip • ‎sicilianu • ‎slovenčina • ‎suomi • ‎svenska • ‎čeština • ‎Ελληνικά • ‎беларуская (тарашкевіца)‎ • ‎български • ‎русский • ‎српски / srpski • ‎татарча/tatarça • ‎українська • ‎հայերեն • ‎ייִדיש • ‎עברית • ‎ئۇيغۇرچە • ‎العربية • ‎تۆرکجه • ‎سنڌي • ‎فارسی • ‎پښتو • ‎मराठी • ‎हिन्दी • ‎মেইতেই লোন্ • ‎ਪੰਜਾਬੀ • ‎ଓଡ଼ିଆ • ‎தமிழ் • ‎తెలుగు • ‎ಕನ್ನಡ • ‎සිංහල • ‎ไทย • ‎ქართული • ‎ትግርኛ • ‎中文 • ‎日本語 • ‎粵語 • ‎한국어
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 qui décrit les étapes pour identifier de tels morceaux de code, que vous pourriez corriger pour 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. Allez sur phabricator.wikimedia.org et cliquez sur « Tasks & bugs » dans la barre latérale.
  2. Choisir « Create task » (créer une tâche) dans le coin supérieur droit.
  3. Si vous n'êtes pas connecté, il vous sera demandé de vous identifier ou de créer un compte (voir « Créer votre compte  »).
  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. Un récit utilisateur est une méthode efficace pour exprimer 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, habillages graphiques et systèmes d'exploitations avec lesquels vous avez constaté le bug ;
        • 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 capture d'écran (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 le ou les projets 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 « Choisir les projets  »).
    • 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.

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

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 vous n'êtes pas sûr que la fonctionnalité que vous utilisez est basée sur JavaScript, essayez de désactiver Javascript.

Il est toujours utile d'inclure une capture d'écran dans votre rapport. C'est souvent le moyen le plus facile d'identifier de quelle fonctionnalité vous parlez, et cela peut souvent fournir des informations qui peuvent aider à cerner l'erreur. Prenez garde à cacher toute information que vous ne voulez pas partager, comme les autres onglets ouverts de votre navigateur ou les fenêtres de discussion minimisées.

Si le problème fait partie 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 peut vous rediriger vers la page de discussion du script en question (si celui-ci a été 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 Manuel:Comment déboguer problème de connection.

Voir aussi

  • phab:T85433