Des rapports de bugs que les développeurs adorent : modèle et exemples réels
Un bon rapport de bug est corrigé plus vite. Voici notre modèle, un mauvais et un bon exemple, et notre façon de fixer gravité et priorité.
Un bug impossible à reproduire n'est pas corrigé. Un rapport qui demande vingt minutes de compréhension à un développeur est repoussé. La qualité des rapports de bugs influence directement la vitesse de livraison d'une équipe : pour nous, les rédiger est une compétence clé de la QA, pas de la paperasse.
Anatomie d'un bon rapport
| Champ | Quoi écrire |
|---|---|
| Titre | Ce qui est cassé, où et dans quelle condition. Court et facile à rechercher |
| Environnement | Build/version, URL, appareil, OS, navigateur, type de compte |
| Préconditions | Données ou état nécessaires avant l'étape 1 |
| Étapes de reproduction | Numérotées, minimales, une action par étape |
| Résultat attendu | Ce qui devrait se passer, idéalement avec un lien vers l'exigence |
| Résultat obtenu | Ce qui se passe à la place, avec le texte d'erreur |
| Preuves | Capture, vidéo, logs, requête réseau (HAR), erreurs console |
| Gravité / Priorité | Impact sur le produit / urgence de la correction |
| Fréquence | Toujours, parfois (3 sur 10), une fois |
Mauvais ou bon
Un mauvais rapport :
Le même bug, bien rapporté :
Titre : Commande – le bouton « Payer » reste désactivé après un code promo sur Safari mobile
Environnement : build de staging 1.4.2 (#1287), iPhone 13, iOS 17.5, Safari
Compte : utilisateur inscrit test.buyer+12@…, panier de 2 articles (64,00 $)
Étapes :
1. Ouvrir /cart
2. Saisir le code SPRING10 et toucher « Appliquer »
3. Toucher « Commander » et saisir une adresse valide
4. Choisir « Carte » comme moyen de paiement
Attendu : le bouton « Payer 57,60 $ » est actif
Obtenu : le bouton reste désactivé ; la console affiche
TypeError: total.toFixed is not a function (checkout.js:214)
Fréquence : 5/5 sur iOS Safari ; non reproductible sur Chrome desktop
Preuves : video.mp4, console.log, fichier HAR joints
Gravité : Critique (impossible de payer) Priorité : Haute
La seconde version peut être corrigée sans une seule question. L'erreur console indique même la ligne de code au développeur.
Gravité ou priorité
La gravité décrit l'impact d'un défaut sur le système. La priorité décrit à quelle vitesse il doit être corrigé. Elles vont souvent ensemble, mais pas toujours, et la différence compte dans la planification.
Notre checklist avant de cliquer sur « Créer »
- Reproduit au moins deux fois, idéalement dans une session propre
- Recherche de doublons faite
- Étapes minimales : tout ce qui est inutile à la reproduction a été retiré
- Un bug par rapport
- Titre compréhensible sans ouvrir le ticket
- Preuves jointes et données sensibles masquées
- Pas d'émotion, pas de reproche, seulement des faits
Après le rapport
Une fois le bug corrigé, la QA vérifie la correction dans le même environnement et lance une courte régression autour. Les bugs récurrents font l'objet d'une analyse des causes racines : pourquoi est-ce arrivé, et quel test, quelle revue ou quelle vérification l'aurait détecté plus tôt ? C'est cette question qui permet aux équipes de ne pas revoir le même type de bug deux fois.