Transformer une plainte client en rapport de bug exploitable par les ingénieurs
Comment le support et la QA peuvent transformer une plainte client vague en rapport de bug : poser les bonnes questions, distinguer ce qui a été vu de ce qui a été supposé, et protéger les données personnelles.
Un client écrit : « Votre export est cassé, j’ai perdu mon travail, réparez ça. » C’est un message furieux, urgent et presque inutile pour un ingénieur. Pas de point de départ, pas d’étapes, pas de build, et aucun moyen de savoir si c’est le produit qui a échoué ou le fichier du client.
La personne qui fait l’intermédiaire, au support ou en QA, doit transformer ce message en quelque chose sur quoi un ingénieur peut agir, sans revenir sans cesse vers le client. Voici comment.
Distinguez ce qui a été vu de ce qui a été déduit
Les clients rapportent des conclusions : « ça a supprimé mes données », « c’est en panne », « la mise à jour a tout cassé ». Sous chacune se cache une observation. Votre premier travail est de la trouver.
- « Ça a supprimé mes données » peut vouloir dire : la liste était vide à l’ouverture du projet.
- « C’est en panne » peut vouloir dire : la page a affiché une erreur après la connexion.
- « La mise à jour a tout cassé » peut vouloir dire : cela marchait lundi et le client a fait la mise à jour mardi.
Écrivez l’observation dans le rapport. Gardez la conclusion, citée et attribuée, comme contexte. Un ingénieur peut agir sur une liste vide. Il ne peut pas agir sur « supprimé ».
Demandez les quelques éléments qui permettent de reproduire
Les longs questionnaires restent sans réponse. Ces questions couvrent généralement ce dont un ingénieur a besoin, et une réponse de quelques lignes suffit :
- Que faisiez-vous juste avant que cela se produise ?
- Qu’attendiez-vous, et qu’avez-vous vu à la place ? Y a-t-il un message que vous pouvez copier ?
- Est-ce arrivé plus d’une fois, et cela arrive-t-il à chaque fois ?
- Quelle version ou quel build, et quel appareil ou navigateur ?
- Est-ce que cela fonctionnait avant ? Si oui, quand l’avez-vous vu fonctionner pour la dernière fois ?
Proposez une capture d’écran ou une courte vidéo si écrire est difficile. Demandez ce qui est facile à fournir.
Essayez de reproduire avant d’escalader
Si vous pouvez suivre les étapes du client et voir le problème, dites-le dans le rapport, avec vos étapes. Si vous ne le pouvez pas, dites-le aussi, en précisant combien de fois vous avez essayé. « Non reproduit sur le build actuel en deux tentatives, le client le signale sur un build plus ancien » est une phrase utile. Elle indique à l’ingénieur par où commencer et lui épargne une heure perdue.
Cherchez des signalements antérieurs
Les plaintes se répètent souvent. Cherchez dans l’outil de suivi avec les mots du client et avec le symptôme que vous avez écrit, et regardez aussi les tickets fermés. S’il y a une correspondance, rattachez-y le nouveau client plutôt que d’ouvrir un autre ticket. Notre article sur le repérage des bugs en double avant le dépôt montre comment bien chercher.
Gardez les données personnelles hors du ticket
Les messages du support contiennent des noms, des e-mails, des numéros de compte et parfois des captures d’écran qui en montrent plus que quiconque ne voulait partager. L’ingénieur en a rarement besoin. Remplacez-les par un marqueur ou une courte référence que votre propre système sait résoudre, et recadrez les images sur la partie qui montre le problème.
Décrivez l’impact par des faits
Les ingénieurs ont besoin de connaître l’impact, mais pas d’une avalanche d’adjectifs. Écrivez ce que le client n’a pas pu faire, s’il existe une solution de contournement, et si d’autres l’ont signalé. Laissez le tri fixer la priorité et mettez les faits dans la description.
Un modèle court
`` Résumé : où, ce qui s’est passé, la condition qui compte Signalement du client (cité) : ... Ce qui a été vu : ... Résultat attendu : ... Étapes (telles que données, ou telles que reproduites par nous) : ... Build et appareil : ... Fréquence constatée : ... Fonctionnait avant ? dernier build fonctionnel connu : ... Contournement : ... Tickets liés : ... ``
La place de BugIt
Le support et la QA rédigent souvent un rapport structuré à partir d’un message confus, de nombreuses fois par semaine. Quand vous collez les mots du client dans votre assistant et décrivez ce que vous avez constaté, BugIt transforme la note en vrac en rapport structuré avec les étapes, les résultats attendu et obtenu et l’environnement, et il cherche les tickets similaires dans votre outil de suivi avant que vous ne voyiez le brouillon. Il masque les données personnelles courantes, au mieux : vérifiez donc le brouillon vous-même. Vous relisez le rapport, 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
Trouvez l’observation sous la plainte, posez quelques questions ciblées, essayez de reproduire, cherchez avant de déposer et gardez les données personnelles à l’écart. L’ingénieur doit pouvoir se mettre au travail à partir du seul ticket.