BugIt4 min de lecture

Repérer les bugs en double avant de les déposer

Pourquoi un même bug se transforme en plusieurs tickets, comment chercher dans un outil de suivi pour retrouver le premier, et que faire quand vous le trouvez.

Un parcours qui va de la description d’un bug à la recherche par symptôme et texte d’erreur, puis à l’examen des candidats, et enfin à l’ajout de preuves, à un lien « associé » ou à un nouveau ticket.

Imaginez un bug sur l’écran de connexion. Lundi, une testeuse écrit « l’indicateur de chargement de la connexion tourne sans fin ». Mardi, un ingénieur du support écrit « impossible de se connecter après la page du mot de passe ». Mercredi, une développeuse trouve un troisième rapport qui mentionne un délai dépassé lors du renouvellement du jeton.

Trois tickets, trois personnes, un seul bug. Chaque ticket détient une partie de la réponse. Le premier contient les étapes, le deuxième un client qui attend, le troisième le journal. Personne ne voit l’ensemble, et quelqu’un va trier trois fois le même problème.

Les doublons ne sont pas le signe d’un manque de rigueur. Ils apparaissent quand différentes personnes décrivent la même chose avec des mots différents. La bonne nouvelle, c’est qu’une courte recherche avant le dépôt en évite la plupart, et que quelques habitudes rendent le reste gérable.

Pourquoi une simple recherche par mot-clé échoue

Une recherche sur « chargement » ne trouvera pas « impossible de se connecter ». Une recherche sur « login » ne trouvera pas « authentification ». Et les outils de suivi grossissent. Le ticket dont vous avez besoin est peut-être fermé, renommé ou enfoui sous des centaines de tickets plus récents.

La recherche demande donc un peu de savoir-faire. Voici une routine qui prend deux ou trois minutes.

Six réflexes avant de déposer

  1. Cherchez le symptôme, pas votre titre. Utilisez les mots qu’un utilisateur verrait : le message à l’écran, le nom de l’écran, l’action qui a échoué.
  2. Cherchez le texte de l’erreur. Si vous avez un nom d’exception ou un code d’état, cherchez-le. Les développeurs les collent souvent dans les tickets, et la correspondance est alors exacte.
  3. Essayez des synonymes. Plantage, gel, blocage et chargement sans fin peuvent décrire une même panne. Tout comme login, connexion et authentification.
  4. Restreignez par zone. Filtrez sur le composant ou l’étiquette correspondant à la partie du produit que vous utilisiez, pour réduire la liste à quelque chose de lisible.
  5. Incluez les tickets fermés. Un bug corrigé qui revient est une régression, et l’ancien ticket en contient l’historique, parfois même la cause.
  6. Suivez les liens. La correspondance se trouve parfois à un lien d’un ticket que vous avez déjà trouvé.

Un ticket similaire n’est pas forcément un doublon, et fusionner les mauvais tickets masque des bugs.

  • Doublon : même symptôme et même cause. Les tickets décrivent un seul problème.
  • Associé : même symptôme avec une cause différente, ou même zone avec un symptôme différent. Gardez-les séparés et liez-les.
  • Différent : seul le vocabulaire correspond. N’y touchez pas.

Dans le doute, considérez-le comme associé et liez-le. Un lien prend quelques secondes, et le responsable de la zone pourra fusionner plus tard, en en sachant plus que vous.

Que faire quand vous trouvez une correspondance

Retrouver le ticket antérieur est un début, pas une fin. Rendez la correspondance utile.

  • Ajoutez ce qui est nouveau. Votre build, vos étapes, un journal, ou une note indiquant qu’un autre client est touché. Les preuves sont la seule chose dont un ticket gagne à avoir davantage.
  • Évitez le ticket « moi aussi ». Ouvrir un second ticket pour dire que vous le constatez aussi disperse à nouveau les preuves. Commentez le premier.
  • Rouvrez avec précaution. Si la correspondance est fermée et que vous pouvez encore reproduire le problème, suivez la pratique de votre équipe : rouvrez-le, ou déposez un nouveau ticket qui renvoie au premier.
  • Demandez un second avis. En cas de doute, déposez votre ticket et liez le candidat comme associé. La personne chargée du tri tranchera.

Limiter les doublons en équipe

La recherche individuelle aide, mais les habitudes d’équipe aident davantage. Un outil de suivi est une mémoire partagée, et il ne fonctionne que si chacun y écrit de façon à ce que la personne suivante puisse retrouver l’information.

  • Convenez d’un format de titre. Quand les tickets d’une même zone se ressemblent, ils se retrouvent côte à côte une fois triés et les doublons sautent aux yeux.
  • Utilisez un petit jeu d’étiquettes pour les composants. Appliquez-les de façon cohérente, pour qu’un filtre trouve ce qu’il doit trouver.
  • Fermez les doublons en les liant. Faites-les pointer vers le ticket conservé, pour que l’historique reste accessible.
  • Parcourez les tickets les plus récents lors du tri. Un coup d’œil de cinq minutes sur ce qui est arrivé depuis la veille repère les paires tant qu’elles sont fraîches.

Un exemple rapide

Vous rencontrez un plantage en exportant un rapport en PDF. Votre première recherche, « plantage export », ne donne rien. Vous cherchez alors le message affiché à l’écran, « could not generate file », et un ticket apparaît, intitulé « Le bouton PDF ne fait rien sur les gros rapports ». Des mots différents, le même symptôme, et les étapes correspondent aux vôtres.

Vous ne déposez pas de nouveau ticket. Vous ajoutez un commentaire avec votre build et la ligne du journal, et vous liez l’autre ticket trouvé qui mentionne le même écran d’export. Deux minutes, aucun nouveau ticket, et le prochain développeur qui l’ouvre voit l’ensemble.

La place de BugIt

Chercher correctement dans un outil de suivi demande de la patience, et c’est justement l’étape que l’on saute quand on est pressé. BugIt s’en charge pour vous. Quand vous décrivez un bug, BugIt cherche dans votre outil de suivi les tickets semblables au vôtre avant que vous ne voyiez le brouillon. La recherche se fait en lecture seule. Elle attribue un score à chaque candidat pour que vous puissiez juger de sa proximité, et elle liste les tickets associés dans le brouillon pour que le lien soit à un clic. Un bug rapide se passe de cette recherche.

C’est une piste, pas un verdict. Vous relisez chaque brouillon avant son dépôt, 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 : bugit.dev et taskivator.com/bugit.

À retenir

Les doublons viennent de mots différents pour un même problème. Cherchez le symptôme et le texte de l’erreur, essayez des synonymes, incluez les tickets fermés et suivez les liens. Quand vous trouvez une correspondance, ajoutez-y vos preuves au lieu d’ouvrir un autre ticket. Deux minutes de recherche évitent à une équipe de corriger, de trier et d’expliquer plusieurs fois le même bug.

DisponibleAgent QA pour votre assistant IA

BugIt

Français