BugIt3 min de lecture

Bug ou comportement attendu ? Comment vérifier avant de déposer

Avant de déposer un ticket, vérifiez si le comportement est un bug, une fonction manquante ou un choix voulu. Une méthode courte qui s’appuie sur la spécification, les notes de version, les réglages et l’outil de suivi.

Un parcours de décision qui part de la vérification de la spécification et mène à trois issues : bug, comportement attendu ou lacune de la spécification.

Certains des tickets les plus coûteux ne sont pas des bugs. Le produit a fait ce pour quoi il a été conçu, l’auteur du signalement s’attendait à autre chose, et un développeur passe une matinée à le démontrer. L’inverse coûte tout autant : un vrai bug est fermé comme « fonctionne comme prévu » parce que l’auteur du signalement n’a pas pu montrer ce que prévoit la conception.

Quelques minutes de vérification avant le dépôt règlent la plupart de ces cas. Voici une méthode.

Partez de la source de référence

Un comportement est un bug lorsqu’il contredit quelque chose sur lequel l’équipe s’est mise d’accord. Cherchez ce quelque chose, dans cet ordre.

  • La spécification, la user story ou les critères d’acceptation. S’ils disent ce qui doit se passer et que le produit fait autrement, vous tenez un bug. Citez la ligne dans le rapport.
  • Les notes de version et les journaux des modifications. Un changement a peut-être été annoncé. Dans ce cas, vous avez affaire à une décision, pas à un défaut, même si vous pouvez toujours la désapprouver.
  • La documentation et les textes d’aide. Les propres mots du produit sont une preuve. Une page qui dit une chose pendant que l’écran en fait une autre mérite d’être signalée dans tous les cas.
  • L’outil de suivi. Cherchez le comportement dans les tickets ouverts et fermés. Un ticket fermé marqué « voulu » vous épargne le dépôt, et un ticket ouvert vous indique d’y ajouter vos preuves.

Écartez votre propre configuration

Une bonne partie des « bugs » vient de l’environnement. Vérifiez ces points avant d’écrire quoi que ce soit.

  • Autorisations et rôles. Le comportement change-t-il avec un compte qui a un autre rôle ?
  • Réglages et feature flags. Un réglage ou un feature flag est-il activé alors que vous ne vous y attendiez pas ?
  • Données. Un nouveau compte, un fichier plus petit ou une autre saisie se comportent-ils différemment ?
  • Version. Êtes-vous sur le build que vous croyez, et est-ce bien celui que décrit la spécification ?
  • Cache et état obsolète. Une session vierge donne-t-elle le même résultat ?

Si la modification de l’un de ces points fait disparaître le comportement, vous avez appris quelque chose de concret. Il peut encore s’agir d’un bug, comme une valeur par défaut déroutante ou un message manquant, mais c’est un autre rapport.

Trois issues honnêtes

| Ce que vous avez constaté | Ce qu’il faut déposer | |---|---| | Le produit contredit la spécification ou sa propre documentation | Un bug. Citez les deux. | | Le comportement est voulu mais surprenant ou peu clair | Un problème d’ergonomie ou de documentation. Dites ce qui vous a induit en erreur. | | Le comportement est voulu et vous souhaitez autre chose | Une demande de fonctionnalité, étiquetée comme telle. |

Déposer dans la bonne catégorie, ce n’est pas du pinaillage. Cela envoie le ticket à la personne qui peut agir, et vos décomptes de défauts restent fidèles à la réalité.

Quand la spécification ne dit rien

Parfois, rien n’indique ce qui doit se passer. Ne devinez pas. Décrivez ce que vous avez fait, ce qui s’est passé et ce que vous attendiez, dites clairement qu’aucune spécification ne couvre ce cas, et demandez au responsable de trancher. Une discussion floue devient ainsi une question claire.

Rédigez un rapport qui résiste au « fonctionne comme prévu »

Si vous déposez effectivement un bug, rendez-le difficile à écarter. Indiquez la source que vous avez vérifiée, citez la ligne qui fixe l’attente, et montrez les étapes et le résultat. Notre guide pour signaler une régression explique comment ajouter la dernière version qui se comportait correctement, une preuve solide que le comportement actuel est un changement et non un choix de conception.

La place de BugIt

BugIt ne décide pas à votre place si quelque chose est un bug, et il ne doit pas le faire. Il prend votre note en vrac et la transforme en rapport structuré avec les étapes, les résultats attendu et obtenu, ce qui fait clairement apparaître la question, et il cherche dans votre outil de suivi les tickets similaires avant que vous ne voyiez le brouillon, pour que vous puissiez retrouver une décision antérieure. Vous relisez le brouillon et choisissez vous-même la catégorie. BugIt masque les données personnelles courantes dans la mesure du possible, et rien n’est écrit dans votre outil de suivi tant que vous n’avez pas tapé FILE IT.

Pour en savoir plus : taskivator.com/bugit et bugit.dev.

À retenir

Vérifiez la spécification, les notes de version, la documentation et l’outil de suivi, écartez votre propre configuration, et déposez dans la catégorie que les preuves justifient. Une courte vérification en amont garde les vrais bugs ouverts et tient à l’écart ce qui n’en est pas.

DisponibleAgent QA pour votre assistant IA

BugIt

Français