Comment rédiger un rapport de bug ?
15 août 2019

Licence Creative Commons

Introduction

Un rapport de bug est un document ayant pour but de fournir des informations au sujet d'un défaut dans une application ou dans un système. Il est généralement rédigé lorsqu'un bug est identifié chez l'utilisateur ou durant la phase de test avant la livraison du produit. Un rapport de bug peut être désigné par différents termes comme rapport de défaut, rapport d'incident, rapport de déviation ou rapport d'anomalie.


Contenu d'un rapport de bug

Idéalement, un rapport de bug doit comporter les éléments ci-dessous:

  • Un identifiant unique
  • Un titre résumant la description de l'anomalie
  • La fonction impactée

  • Une description détaillée de l'anomalie
  • Les étapes pour reproduire l'anomalie
  • Une capture écran montrant l'anomalie

  • La version du logiciel ou du système
  • L'environnent de reproduction de l'anomalie

  • Le degré de sévérité ou de criticité de l'anomalie
  • Le degré de priorisation de l'anomalie
  • Le status de l'anomalie. Par exemple: Nouveau, Rejeté, Corrigé, ...
  • La reproductibilité de l'anomalie

  • L'auteur du rapport de l'anomalie
  • La date de création du rapport
  • La date de modification du rapport de l'anomalie
  • La personne chargé de la résolution ou du traitement de l'anomalie

Un exemple d'un rapport de bug.



Normes et qualité

En matière de processus qualité et de normalisation, la partie 3 de la norme « ISO/IEC/IEEE 29119: Systems engineering -- Software testing » consacré à la documentation fournit des modèles et des exemples pour la rédaction d'un bon rapport de bug. Il s'agit d'une norme internationalement reconnue qui remplace l'ancienne norme IEEE 829.


Outils

Des outils de suivi de bugs (Bug Tracker) comme Mantis, Jira, Trac ou Bugzilla peuvent être utilisés pour la rédaction, le stockage et la gestion des rapports de bugs.




Références: