Modèle de rapport de bug gratuit : Jira, GitHub, Linear
Un modèle de rapport de bug gratuit à copier-coller, des versions prêtes pour GitHub, Linear et Jira, un formulaire GitHub et un exemple rempli.
Un modèle de rapport de bug est un ensemble fixe de champs qui oblige chaque rapport à répondre aux mêmes questions : qu’est-ce qui ne va pas, où, comment le reproduire, que devait-il se passer, et quelles preuves le montrent. Le modèle ci-dessous couvre le titre, le résumé, l’environnement, les étapes de reproduction, les résultats attendu et obtenu, la fréquence, la gravité, les pièces jointes et les logs. Copiez-le dans votre outil de suivi, un formulaire de support ou un message de chat, et remplissez les blancs. Plus bas, vous trouverez des versions prêtes à l’emploi pour GitHub, Linear et Jira, dont un formulaire d’issue GitHub.
Les modèles existent parce que les développeurs perdent l’essentiel de leur temps à cause des détails manquants, pas sur la correction elle-même. Un rapport avec des étapes précises, la version du navigateur et l’erreur console peut souvent être corrigé le jour même. Un rapport qui dit « le paiement est cassé » se transforme en un long fil de questions.
Le modèle
Titre : [Ce qui est cassé] quand [action] sur [page ou fonctionnalité]
Résumé
Une ou deux phrases en langage simple. Ce qui s’est passé et qui est touché.
Environnement
- URL :
- Navigateur et version :
- Système d’exploitation :
- Appareil / taille d’écran :
- Version ou build de l’application (si connu) :
- Compte / rôle / utilisateur de test :
- Date et heure de l’incident (avec fuseau horaire) :
Étapes de reproduction
1.
2.
3.
Résultat attendu
Ce qui aurait dû se passer.
Résultat obtenu
Ce qui s’est passé à la place. Indiquez le message d’erreur exact, copié en texte.
Fréquence
Systématique / Intermittent (environ X essais sur Y) / Arrivé une seule fois
Gravité
Bloquant / Majeur / Mineur / Cosmétique
Contournement
Tout moyen de contourner le problème, ou « Aucun trouvé ».
Pièces jointes
- Capture d’écran ou enregistrement d’écran :
- Erreurs console :
- Requête réseau en échec (URL, statut, réponse) :
- Fichier HAR (nettoyé), si demandé :
Notes
Tout le reste : quand cela a commencé, ce qui a changé récemment, tickets liés.
Comment remplir chaque champ
Titre
Le titre est ce qu’on parcourt des yeux dans une liste de cinquante tickets : rendez-le précis. Une formule utile : « ce qui est cassé » + « quand » + « où ». « Le bouton Payer reste désactivé après la saisie d’une carte valide au paiement » vaut mieux que « Bug paiement ». Évitez les mots comme « urgent » ou « cassé » employés seuls ; c’est le champ de gravité qui porte cette information.
Résumé
Une ou deux phrases qu’un collègue non technique peut comprendre. Indiquez qui est touché si vous le savez : tous les utilisateurs, seulement les admins, seulement les utilisateurs de Safari, un seul client.
Environnement
Beaucoup de bugs dépendent du navigateur, de l’appareil, du compte ou des données. Notez l’URL exacte, le nom et la version du navigateur, le système d’exploitation, et le compte ou le rôle utilisé. Si l’application affiche un numéro de version ou de build, ajoutez-le. L’heure de l’échec, avec votre fuseau horaire, permet au développeur de retrouver les entrées correspondantes dans les logs serveur.
Étapes de reproduction
C’est le champ le plus important. Numérotez les étapes, partez d’un état connu (« connecté avec un utilisateur au panier vide ») et indiquez les données exactes utilisées. Une action par étape. Si vous n’avez pas réussi à le reproduire une seconde fois, dites-le et décrivez le plus fidèlement possible ce que vous avez fait la première fois.
Résultat attendu et résultat obtenu
Placez-les côte à côte pour que l’écart saute aux yeux. Copiez les messages d’erreur en texte au lieu de les paraphraser : le développeur va chercher cette chaîne exacte dans le code. « Il ne se passe rien » est un résultat obtenu valable, mais précisez ce que vous avez vérifié, par exemple « aucun message d’erreur, le bouton reste actif ».
Fréquence
Les bugs « systématiques » sont les plus faciles à corriger. Les bugs « intermittents » demandent plus de données : estimez le taux (« 3 essais sur 10 ») et notez tout ce qui semble jouer un rôle, comme une connexion lente ou un gros fichier.
Gravité
La gravité mesure l’impact, pas votre niveau d’agacement. Une échelle courante :
| Gravité | Signification | Exemple |
|---|---|---|
| Bloquant | Parcours principal impossible, pas de contournement | Personne ne peut se connecter |
| Majeur | Fonctionnalité importante cassée ou données fausses, contournement pénible | Les factures affichent un mauvais total |
| Mineur | La fonctionnalité marche avec un petit problème ou un contournement simple | Le tri se réinitialise après un rechargement de page |
| Cosmétique | Problème visuel, sans impact fonctionnel | Le texte du bouton déborde sur les petits écrans |
La priorité, qui décide quand le bug sera corrigé, est généralement fixée par l’équipe propriétaire du backlog, pas par la personne qui le signale.
Contournement
Un contournement indique à l’équipe l’urgence de la correction et aide le support à répondre aux clients en attendant.
Pièces jointes et logs
Ce sont les preuves qui font gagner le plus de temps. Joignez une capture d’écran avec la zone du problème signalée, ou un court enregistrement d’écran qui montre les étapes. Pour les applications web, ajoutez les erreurs console et la requête réseau en échec. Nos guides pour exporter les logs console dans Chrome et capturer le trafic réseau dans Chrome expliquent comment faire. Si quelqu’un vous demande un fichier HAR, suivez comment obtenir un fichier HAR et nettoyez-le d’abord avec le nettoyeur HAR, car les fichiers HAR contiennent des cookies et des tokens.
Un exemple rempli
Titre : Le bouton Payer reste désactivé après la saisie d’une carte valide au paiement
Résumé
Sur la page de paiement, le bouton Payer ne devient jamais cliquable après la
saisie d’une carte de test valide : la commande ne peut pas être passée.
Constaté dans Chrome et Edge.
Environnement
- URL : https://staging.example.com/checkout
- Navigateur et version : Chrome 154 sous Windows 11 ; aussi Edge 154
- Appareil / taille d’écran : ordinateur portable, 1920x1080
- Version ou build de l’application : web 4.18.0 (pied de page)
- Compte / rôle / utilisateur de test : [email protected], client standard
- Date et heure : 2026-11-10 14:32 CET
Étapes de reproduction
1. Se connecter avec [email protected].
2. Ajouter « Starter plan, annual » au panier.
3. Aller sur /checkout.
4. Saisir la carte de test 4242 4242 4242 4242, expiration 12/30, CVC 123.
5. Cliquer en dehors du champ de la carte.
Résultat attendu
Le bouton Payer devient actif et affiche « Payer 120,00 $ ».
Résultat obtenu
Le bouton Payer reste gris et désactivé. Aucun message d’erreur ne s’affiche.
La console affiche : Uncaught TypeError: Cannot read properties of
undefined (reading 'postalCode') at validateCard (checkout.js:214)
Fréquence
Systématique (5 essais sur 5)
Gravité
Bloquant : les clients ne peuvent pas payer
Contournement
Aucun trouvé. Fonctionne sur le build de production 4.17.2.
Pièces jointes
- Enregistrement d’écran : lien dans les commentaires
- Erreurs console : checkout-console.log
- Réseau : POST /api/cart/validate a renvoyé 200 ; aucun autre échec
Notes
Apparu après le déploiement de ce matin en préproduction.
Remarquez ce qui rend cet exemple efficace. Les étapes partent d’un compte connu. La carte de test est nommée. L’erreur console est citée mot pour mot. La personne a vérifié un autre navigateur et le build précédent, ce qui réduit déjà la cause au dernier changement.
Versions plus courtes
Tous les bugs n’ont pas besoin de tous les champs. Pour un message rapide dans le chat de l’équipe, une version compacte suffit :
Bug : [titre]
Où : [URL], [navigateur/OS]
Étapes : 1) ... 2) ... 3) ...
Attendu : ...
Obtenu : ...
Preuves : [capture d’écran / enregistrement / erreur console]
Pour les équipes de support client qui transmettent le signalement d’un utilisateur, ajoutez l’identifiant du compte client, le lien vers le ticket et les mots du client lui-même, et indiquez quelles parties vous avez reproduites vous-même.
Pour les campagnes de test QA, ajoutez l’identifiant du cas de test et le build testé, pour que le bug renvoie au test qui l’a trouvé.
Modèles pour GitHub, Linear et Jira
Le modèle en texte brut fonctionne partout. Si votre outil de suivi affiche le Markdown, cette version garde les rubriques et les cases à cocher lisibles :
## Résumé
<!-- Une ou deux phrases : ce qui s’est passé et qui est touché. -->
## Environnement
- URL :
- Navigateur et version :
- Système d’exploitation :
- Version ou build de l’application :
- Compte / rôle :
## Étapes de reproduction
1.
2.
3.
## Résultat attendu
## Résultat obtenu
<!-- Collez le message d’erreur exact, en texte. -->
## Fréquence
<!-- Systématique / Intermittent (X sur Y) / Une seule fois -->
## Gravité
<!-- Bloquant / Majeur / Mineur / Cosmétique -->
## Preuves
- [ ] Capture d’écran ou enregistrement d’écran
- [ ] Erreurs console
- [ ] Requête réseau en échec
GitHub Issues
Enregistrez la version Markdown sous .github/ISSUE_TEMPLATE/bug_report.md dans votre dépôt, avec un court en-tête pour que GitHub la propose dans le sélecteur « New issue » :
---
name: Rapport de bug
about: Quelque chose est cassé
labels: bug
---
GitHub prend aussi en charge les formulaires d’issue, qui transforment le modèle en champs étiquetés impossibles à sauter. Enregistrez ceci sous .github/ISSUE_TEMPLATE/bug_report.yml :
name: Rapport de bug
description: Quelque chose est cassé
labels: ["bug"]
body:
- type: textarea
id: summary
attributes:
label: Résumé
description: Qu’est-ce qui s’est passé, et qui est touché ?
validations:
required: true
- type: input
id: url
attributes:
label: URL
- type: input
id: environment
attributes:
label: Navigateur, OS et version de l’application
placeholder: Chrome 154 sous macOS 26, web 4.18.0
- type: textarea
id: steps
attributes:
label: Étapes de reproduction
value: |
1.
2.
3.
validations:
required: true
- type: textarea
id: expected
attributes:
label: Résultat attendu
validations:
required: true
- type: textarea
id: actual
attributes:
label: Résultat obtenu
description: Collez le message d’erreur exact, en texte.
validations:
required: true
- type: dropdown
id: severity
attributes:
label: Gravité
options:
- Bloquant
- Majeur
- Mineur
- Cosmétique
- type: textarea
id: evidence
attributes:
label: Captures d’écran, enregistrement et logs
description: Glissez des fichiers ici ou collez le lien d’un enregistrement.
Linear
Linear propose des modèles d’issue dans les paramètres d’une équipe. Créez-en un nommé « Bug », collez la version Markdown dans sa description, et définissez le label Bug et l’état de triage de l’équipe, pour que chaque rapport commence avec les mêmes champs.
Jira
Dans Jira, collez la version texte ou Markdown dans la description d’un nouveau Bug. Jira Cloud n’a pas de description par défaut intégrée pour chaque type de ticket : les équipes qui veulent le modèle prérempli utilisent une application de modèles de tickets de l’Atlassian Marketplace. Le lien vers un enregistrement d’écran avec les logs console et réseau va dans la description ou dans un commentaire.
Les erreurs que le modèle évite
Un modèle est surtout une checklist contre les mêmes quelques erreurs :
- Plusieurs bugs dans un seul rapport. Un ticket par problème, pour que chacun puisse être corrigé, testé et clôturé séparément.
- Des erreurs paraphrasées. « Ça parlait de permissions » ne se recherche pas. Le message exact, si.
- Pas de point de départ. Des étapes qui commencent au milieu d’un parcours ne fonctionnent que pour la personne qui les a écrites.
- Des opinions au lieu d’observations. « L’API est cassée » est une supposition. « POST /api/orders a renvoyé 500 » est un fait que le développeur peut vérifier.
- Des secrets dans les pièces jointes. Les captures de panneaux d’administration, les fichiers HAR et les logs console peuvent contenir des tokens et des données clients. Recadrez, floutez ou nettoyez avant de joindre.
En faire le standard de l’équipe
La plupart des outils de suivi permettent d’enregistrer une description ou un modèle de ticket par défaut, pour que chaque nouveau bug commence avec ces rubriques. Gardez le modèle assez court pour que les gens le remplissent vraiment. Si un champ reste vide dans la plupart des rapports, supprimez-le. Si les développeurs posent sans cesse la même question de relance, ajoutez un champ pour y répondre.
Laisser l’outil remplir les champs techniques
Les champs les plus souvent oubliés sont les champs techniques : version du navigateur, erreurs console, requête en échec. Midge, une extension Chrome gratuite, les joint automatiquement à un enregistrement d’écran ou à une capture d’écran : la personne qui signale n’écrit plus que le titre, les étapes et le résultat attendu. Chaque enregistrement contient les logs console, les requêtes réseau, les actions utilisateur et les infos sur l’appareil. Mots de passe, numéros de carte, tokens et cookies sont masqués dans votre navigateur avant que quoi que ce soit ne quitte votre appareil. Un rapport part directement vers Jira, Linear, GitHub Issues ou Slack, ou se partage sous forme de lien que vous pouvez coller n’importe où.
Guides associés
Questions fréquentes
Que doit contenir un modèle de rapport de bug ?
Un titre clair, l’environnement (URL, navigateur, OS, version de l’application, compte), des étapes de reproduction numérotées, le résultat attendu, le résultat obtenu, la fréquence, la gravité, et des preuves comme des captures d’écran, une vidéo, les logs console et les requêtes réseau.
Puis-je utiliser ce modèle dans Jira, Linear ou GitHub Issues ?
Oui. C’est du texte brut avec des rubriques compatibles Markdown : vous pouvez le coller dans n’importe quel outil de suivi. GitHub et Linear peuvent aussi l’enregistrer comme modèle d’issue, et Jira avec une application du Marketplace.
Où placer les modèles d’issue GitHub ?
Dans le dossier .github/ISSUE_TEMPLATE du dépôt. Un fichier .md ajoute un modèle Markdown, et un fichier .yml ajoute un formulaire d’issue avec des champs obligatoires. GitHub les propose quand quelqu’un ouvre une nouvelle issue.
Quelle est la différence entre gravité et priorité ?
La gravité décrit à quel point le bug affecte le produit ou les utilisateurs. La priorité indique dans quel délai l’équipe va le corriger. Un bug grave sur un écran d’administration rarement utilisé peut avoir une priorité plus basse qu’un bug cosmétique sur la page des tarifs.
Dois-je remplir tous les champs ?
Non. Le titre, les étapes et les résultats attendu et obtenu sont essentiels. Remplissez le reste quand vous le connaissez, et écrivez « inconnu » plutôt que de deviner.