Bêta mumus est en bêta publique : gratuit pendant que nous le testons avec de vraies équipes. Vous avez remarqué quelque chose d'étrange ? Dites-le-nous.

Comment rédiger un bon rapport de bug, avec un modèle

Un bon rapport de bug permet à un développeur de reproduire le problème sans poser une seule question. Ce guide explique quoi inclure, vous donne un modèle à copier et montre les erreurs qui rendent les bugs difficiles à corriger.

Qu'est-ce qu'un bon rapport de bug ?

Un bon rapport de bug est précis, reproductible et complet. Il décrit un seul problème, explique comment le provoquer, indique ce qui était attendu à la place et précise l'environnement dans lequel il s'est produit. Un développeur qui le lit peut ouvrir la page et voir le bug en moins d'une minute.

Les huit éléments d'un bon rapport de bug

  1. Titre. Un court résumé de ce qui ne va pas et où. « Paiement - le bouton Payer ne fait rien sur mobile » vaut mieux que « Bug dans le paiement ».
  2. Adresse de la page. L'URL exacte où le problème se produit.
  3. Étapes pour reproduire. Des étapes numérotées à partir d'un point de départ connu.
  4. Résultat attendu. Ce qui aurait dû se passer.
  5. Résultat obtenu. Ce qui s'est passé à la place, avec le message d'erreur exact s'il y en a un.
  6. Environnement. Navigateur et version, système d'exploitation, appareil, taille de l'écran ou de la fenêtre, connecté ou non, et le rôle de l'utilisateur.
  7. Preuves. Une capture d'écran avec le problème signalé, ou un court enregistrement d'écran pour les problèmes de comportement.
  8. Détails techniques. Les erreurs de la console et les requêtes réseau en échec, si vous pouvez les obtenir.

Ajoutez une priorité si votre équipe en utilise, par exemple critique (bloque une fonction principale, sans solution de contournement), haute, normale ou basse.

Modèle de rapport de bug

Copiez ce modèle dans votre outil de suivi, votre e-mail ou votre messagerie.

Title: [Area] - [what is wrong]

Page: https://
Steps to reproduce:
1.
2.
3.
Expected result:
Actual result:

Environment: [browser + version], [operating system], [device], [window size]
Logged in as: [role or "not logged in"]
Evidence: [screenshot / recording]
Console errors / failed requests: [if available]
Priority: [critical / high / normal / low]

Exemple

Title: Product page - price shows "12.9" without the euro sign

Page: https://shop.example/coffee/autumn-roast
Steps to reproduce:
1. Open the product page
2. Choose the 250 g variant
Expected result: the price shows "€12.90"
Actual result: the price shows "12.9"

Environment: Chrome 131, macOS 15, 1440 x 900 window
Logged in as: not logged in
Evidence: screenshot attached
Console errors: none
Priority: high (visible to every customer)

Erreurs courantes

  • Plusieurs problèmes dans un même rapport. Ils sont corrigés, testés et clôturés à des moments différents ; signalez-les séparément.
  • Aucune étape. « Ça ne marche pas » ne peut pas être reproduit. Partez d'une page connue et listez chaque clic.
  • Environnement manquant. De nombreux bugs de mise en page n'apparaissent qu'à une certaine taille de fenêtre ou dans un seul navigateur.
  • Captures d'écran sans contexte. Signalez le problème et incluez la barre d'adresse ou l'adresse de la page.
  • Des opinions présentées comme des faits. « Le bleu est moche » est une demande de modification, pas un bug. Dites ce que vous souhaiteriez à la place.

Laisser un outil enregistrer les détails

Relever à la main l'environnement et les erreurs de la console est fastidieux et facile à oublier. Un outil de signalement visuel de bugs les enregistre automatiquement. Avec mumus, la personne qui signale clique sur l'élément défectueux et rédige le titre, les étapes et le résultat attendu ; la capture d'écran, l'adresse de la page, le navigateur, la taille de la fenêtre, les erreurs de la console et les requêtes en échec sont ajoutés automatiquement.

Questions fréquentes

Que doit contenir un rapport de bug ?

Un titre clair, l'adresse de la page, des étapes numérotées pour reproduire le problème, le résultat attendu et le résultat obtenu, l'environnement (navigateur, système d'exploitation, appareil, taille de la fenêtre, rôle de l'utilisateur), une capture ou un enregistrement d'écran, ainsi que les erreurs de la console ou les requêtes réseau en échec si elles sont disponibles.

Comment rédiger les étapes pour reproduire un bug ?

Partez d'un état connu, par exemple l'adresse d'une page et le fait d'être connecté ou non, puis listez chaque action sous forme d'étape numérotée jusqu'à ce que le problème apparaisse. Testez vous-même les étapes une fois avant d'envoyer le rapport.

Plus de questions dans le centre d'aide

Transformez les retours sur votre site web en tâches que votre équipe peut corriger.