Dans cet article, tu apprendras comment documenter correctement ton bogue selon nos règles et normes. Afin de comprendre un bogue, les clients ont besoin d'informations suffisantes avec une documentation de haute qualité. Tu trouveras des informations plus détaillées sur nos règles dans chaque section de cet article, mais voici un résumé rapide de nos exigences de rapport de bogue:
Si tu signales un bogue fonctionnel, tu dois sélectionner une des Gravités disponibles avant de remplir le reste du rapport de bogue.
Le Titre doit résumer le bug et contenir les informations nécessaires pour comprendre le problème sans ouvrir le rapport de bug. Les informations nécessaires comprennent ce qui s’est passé, où le bug s’est produit, ainsi que quand, comment ou dans quelle condition il a été déclenché.
L'URL doit être celle de la page web où le bug s’est produit. Vous pouvez simplement copier l’URL depuis la barre d’adresse de votre navigateur.
Documentez les étapes qui, une fois suivies, permettent de reproduire le bug.
Le Résultat Réel devrait être formé d'une ou plusieurs phrases expliquant ce qui s'est passé après la dernière action. Tu peux aussi ajouter les résultats d'actions précédentes s'ils sont nécessaires pour comprendre le bogue. Il ne doit pas être identique au titre.
Réfléchissez à ce qui aurait dû se passer si aucun bug n'avait existé et indiquez cette attente dans le champ Résultat Attendu.
Ajoutez une pièce jointe montrant le bug afin de le démontrer visuellement et de confirmer son existence.
Enfin, tu dois sélectionner l'Environnement Utilisé et le navigateur corrects (si applicable) utilisés pour les tests, basés sur l'appareil avec lequel tu as été invité à tester quand tu as accepté le cycle.
Ta première étape dans le formulaire de rapport de bogue devrait être de sélectionner la bonne Fonctionnalité. Si tu ne peux pas trouver la bonne Fonctionnalité dans la liste déroulante, retourne à la page de vue d'ensemble du test, passe en revue toutes les descriptions de Fonctionnalités et marque-les comme lues. Après cela, tu peux retourner au formulaire de rapport de bogue et toutes les Fonctionnalités seront présentées dans la liste déroulante.
Formulaire de Bogue
Après avoir sélectionné la Fonctionnalité, tout le formulaire de bogue sera visible pour toi. Un formulaire pour bogues fonctionnels, par exemple, ressemble à ceci:
Tu devrais remplir chaque champ du formulaire de bogue avec les informations spécifiques correctes selon nos normes de qualité. Des informations plus détaillées sur chaque champ et ses exigences peuvent être trouvées ci-dessous.
Gravité
Pour les bogues Fonctionnels seulement, tu verras un champ supplémentaire appelé Gravité : Faible, Élevée, et/ou Critique. La gravité indique l'urgence de ton rapport et dépend de multiples facteurs. Pour en apprendre sur les différents niveaux de gravité, visite l'article suivant Bogues Fonctionnels.
Le champ Gravité ne sera pas affiché pour d'autres Types de bogues.
Titre
Le titre du rapport de bug doit résumer le bug afin que le lecteur puisse se faire une idée générale du problème simplement en lisant le titre. Il ne devrait pas avoir à lire l’ensemble du rapport pour comprendre de quel bug il s’agit. Le titre de votre rapport de bug doit être précis et concis.
Un bon titre de bug contient les informations nécessaires pour comprendre le problème et le distinguer des autres rapports de bugs. Les informations nécessaires comprennent les éléments suivants :
Que s’est-il passé ?
Où le bug s’est-il produit ?
Quand, comment ou dans quelle condition a-t-il été déclenché ?
Quand tu écris un titre de bogue, décris ce qui se passe au lieu de ce qui ne se passe pas. Ton titre ne devrait jamais déclarer que quelque chose ne fonctionne pas, sinon le lecteur n'a aucune idée de ce qui se passe réellement.
Les titres doivent refléter le vrai problème. Si le bogue ne se produit que sous certaines conditions, les conditions doivent être incluses dans le titre du bogue. Si tu n'es pas capable, par exemple, de réserver un billet quand tu déclares que tu es un adolescent, c'est une information pertinente et doit être incluse dans ton titre.
Pour créer un titre descriptif, mets-toi à la place de quelqu'un qui n'a jamais testé le site web/l'application, qui ne peut pas imaginer sur quelle page tu es, à quoi elle ressemble et ce que tu as fait. Lis ton titre du point de vue de cette personne pour voir si tu comprendrais le bogue. Si tu n'as pas une bonne idée du bogue, ajuste le titre du bogue et répète le processus.
Titres de bogue exemplaires
Correct | Faux |
Un message d’erreur s’affiche sur la page Checkout lors de la soumission d’une commande avec PayPal. | Checkout ne fonctionne pas. |
La page Cart affiche une erreur 404 lorsqu’elle est ouverte par un utilisateur connecté. | La page Cart affiche une erreur 404. |
URL
Accédez à la page où le bug apparaît, puis copiez et collez l’URL depuis la barre d’adresse de votre navigateur dans le champ URL du formulaire de rapport de bug. L’URL doit être valide.
Exemples
Scénario | URL correcte | URL Faux |
Le bouton « Ajouter au panier » ne réagit pas sur une page PDP | L’URL de la Page de détail du produit (PDP) sur laquelle le bouton a été cliqué. Exemple : | Toute autre URL de page |
Un lien redirige vers une page 404 | L’URL de la page contenant le lien défectueux. Exemple : | L’URL de la page 404. Exemple : |
Étapes pour reproduire
Les bogues doivent être reproductibles et ils ont besoin d'un guide détaillé étape par étape sur comment ils peuvent être reproduits. Chaque étape devrait décrire une action séparée.
Note que tu n'as pas à numéroter tes étapes car c'est fait automatiquement par notre système.
La première étape doit indiquer qu’il faut accéder à l’URL de l’environnement du client fournie dans la section Access si vous testez un site web, ou qu’il faut ouvrir l’application (en indiquant son nom) si vous testez une application mobile. Exemple :
Pour les sites web :
Ouvrez https://test.io/
Pour les applications mobiles :
Ouvrez l’application testNow
Toutes les étapes suivantes doivent décrire vos actions depuis l’étape initiale jusqu’au moment où le bug se produit : les boutons sur lesquels vous cliquez, les liens que vous suivez et les informations que vous saisissez. Votre dernière étape doit décrire l’action que vous effectuez et qui déclenche le bug.
Tes étapes devraient être aussi générales que possible. Seulement si ton bogue se produit sous des conditions spécifiques, par exemple seulement pour une page de vue d'ensemble de produit spécifique, pour un filtre spécifique, pour une saisie spécifique, etc., nomme cette condition dans tes étapes. Par exemple, dans tes étapes, ne décris pas la page de vue d'ensemble de produit spécifique que tu as visitée, puis le produit spécifique que tu as ajouté au panier si le problème se produit pour n'importe quel produit. Cela aidera le lecteur à saisir l'idée de ton bogue et il ne sera pas distrait par des détails non pertinents.
Enfin, assure-toi que tes étapes contiennent le moins d'actions possible à effectuer. Après avoir lu chaque étape, la personne reproduisant ton bogue signalé devrait être capable de les compléter sur le site web ou l'application. Elle ne devrait pas avoir à vérifier la même étape plusieurs fois pour se rappeler ce qui doit être fait.
Étapes exemplaires
Saisis n'importe quelle requête de recherche dans la barre de recherche en haut à droite (par exemple "San Francisco")
Clique sur le bouton "Rechercher Maintenant"
Descends et clique sur "Trier par"
Sélectionne l'option "Trier par prix : Du plus élevé au plus bas"
Résultat Actuel
Le résultat actuel est un des champs les plus importants d'un rapport de bogue parce qu'ici tu expliques quel est le problème et tous les détails supplémentaires qui sont nécessaires pour comprendre le bogue.
Ce qui arrive réellement après avoir suivi ton guide étape par étape devrait être décrit de la façon la plus détaillée possible. Essaie d'être très précis et ne sois pas trop général en disant par exemple que les produits restent principalement dans le même ordre après avoir appliqué la méthode de tri X mais décris plutôt des exemples spécifiques des produits qui ne sont pas dans le bon ordre. Ajoute toute information dans ce champ qui est pertinente au bogue, par exemple exemples, conditions supplémentaires, exceptions ou résultats d'autres importants si nécessaire. Assure-toi juste de structurer tes informations pour aider le lecteur à comprendre ton processus de réflexion.
Notes importantes: Les résultats actuels et attendus ne doivent jamais être juste l'opposé l'un de l'autre. L'attente de ce qui aurait dû arriver et ce qui s'est réellement passé à la place diffèrent grandement.
De même, le résultat actuel ne doit pas être identique au titre du rapport. Tandis que le titre est un résumé du problème, le résultat actuel devrait être une description détaillée de celui-ci et devrait inclure des détails supplémentaires tels que des informations de scénario, des exemples et des résultats obtenus lors de l'exécution des étapes pour reproduire le bogue.
Résultat actuel exemplaire
Correct | Faux |
"Erreur 500 - Erreur de Serveur Interne - Désolé quelque chose s'est mal passé" est montré à l'utilisateur après qu'il essaie de procéder à la page Commande. | Erreur montrée sur la page Panier après avoir cliqué sur le bouton Commande. |
Un message d'erreur "Erreur Inattendue" apparaît dans le coin supérieur droit de la PDP, et le produit n'est pas ajouté au Panier. | L'utilisateur ne peut pas ajouter un produit au Panier, une erreur est montrée. |
Résultat Attendu
Décrivez ce que vous vous attendez à voir après avoir effectué la dernière étape que vous avez décrite. Réfléchissez à ce qui aurait dû se passer si vous n’aviez pas rencontré le bug, c’est-à-dire si tout avait fonctionné correctement.
Le résultat attendu doit contenir une courte description, mais pour les bugs plus complexes, des informations supplémentaires peuvent être nécessaires.
N'oubliez pas que le résultat attendu n'est pas la même chose que le résultat réel avec quelques légères variations ou des mots négatifs, mais un champ différent conçu pour vous permettre d'expliquer tout ce qui aurait dû se passer après l'exécution de la dernière étape de reproduction du bug.
Exemple de résultat attendu
Correct | Faux |
La page Checkout devrait se charger correctement. | L'utilisateur devrait être correctement redirigé vers la page Checkout, où il devrait pouvoir ajouter les informations de livraison et de paiement, puis passer une commande. |
« Batman T-Shirt » devrait être ajouté au panier afin que l'utilisateur puisse poursuivre sa commande. | Le produit « Batman T-Shirt » devrait être ajouté au panier avec succès. L'utilisateur ne devrait pas rencontrer d'erreurs telles que « Error 500 » et devrait pouvoir finaliser l'achat de tous les articles de son panier. |
Pièces jointes
Pour apprendre quel type de pièce jointe doit être jointe pour ton bogue et quelles règles s'appliquent, visite l'article suivant: Exigences pour les pièces jointes aux rapports de bogue.
Environnement utilisé
Il est important pour nous et nos clients de savoir quel appareil tu as utilisé quand tu as expérimenté le bogue. Lors du test d'un site web, clique sur l'icône du navigateur à côté de l'appareil que tu as utilisé. Lors du test d'une application mobile, sélectionne l'appareil que tu as utilisé pour les tests et qui a l'application installée.
Tu peux seulement utiliser les appareils pour les tests qui sont listés dans cette section. De plus, tu devrais sélectionner seulement un appareil ou navigateur quand tu signales le bogue, et télécharger seulement des pièces jointes pour celui-ci. Si tu peux reproduire le bogue sur d'autres appareils ou navigateurs, mentionne ceci dans ton Résultat actuel.
Sélectionner l'environnement correct où le bogue se produit est une action obligatoire. Quand tu soumets ton rapport, assure-toi de sélectionner l'environnement correct. Si tu sélectionnes accidentellement le mauvais environnement, tu peux le corriger après l'avoir soumis. Tu peux faire cette correction en changeant ta sélection d'environnement avant que le chef d'équipe révise le rapport de bogue. Si le rapport de bogue contient le mauvais environnement, le TL le rejettera pendant la révision du rapport de bogue.
Tu aimerais tester avec un appareil qui n'est pas dans la liste des appareils disponibles dans ton profil? Envoie-nous simplement une demande via le chat Support et nous ajouterons ton appareil à ta liste pourvu qu'il soit pertinent pour nos clients.
Note: Quand tu supprimes l'appareil pour lequel tu as été invité de ta liste d'appareils dans ton profil de testeur, tu ne peux plus soumettre de rapports dans ce test. La section environnement du formulaire de bogue sera vide et le formulaire ne pourra pas être envoyé. Supprimer un appareil dans ton profil ne peut pas être inversé après que tu aies accepté une invitation de test!
Améliorer ton rapport
Après avoir soumis ton rapport, tu peux encore éditer tous les champs sauf le type de bogue sélectionné. Tu dois toujours soumettre des rapports de bogue complets qui sont prêts à être révisés et utiliser seulement l'option Éditer dans le cas où tu as fait une petite erreur de frappe ou veux reformuler tes mots pour améliorer la qualité du rapport.
Rappelle-toi que les espaces réservés ne sont pas autorisés, donc ne soumets pas de rapports incomplets pour les éditer plus tard.
Si ton bogue n'arrive qu'avec une saisie spécifique, utilise des termes qui seraient utilisés par de vrais utilisateurs et évite de saisir des mots-clés aléatoires lors de la création du rapport de bogue ou des pièces jointes. Un mauvais exemple serait d'utiliser un nom d'utilisateur lors de la création d'un compte sur l'interface client tel que "asdsdfkg_lajsdh" car cela fait paraître ton rapport non professionnel.
Dans le cas où tu as soumis un rapport de bogue par erreur, tu peux le supprimer, mais seulement s'il n'a PAS été révisé par le Chef d'Équipe encore.









