Chaque bogue doit être documenté avec au moins une pièce jointe. Avec tes pièces jointes, tu fournis la preuve que le bogue se produit sur ton appareil, système d'exploitation et/ou navigateur.
Note : Les pièces jointes ne remplacent PAS les informations écrites dans ton rapport. Les pièces jointes sont une visualisation du problème et servent de preuve.
Capture d'écran ou screencast ?
En général, les bogues fonctionnels nécessitent un screencast pour être illustrés correctement et efficacement. Sauf si les instructions ou le chef d'équipe demandent des pièces jointes spécifiques, utilise la règle générale suivante pour déterminer si une capture d'écran ou un screencast est requis pour ton bogue :
Chaque fois qu'une action est requise pour déclencher un bogue ou quand un processus doit être illustré, télécharge un screencast. Les captures d'écran comme images statiques sont des instantanés et ne peuvent pas illustrer la cause racine. Les bogues fonctionnels nécessiteront toujours un screencast pour cette raison.
Quand la nature d'un bogue est statique, par exemple pour des problèmes d'interface graphique statiques, une capture d'écran suffit et est une meilleure visualisation qu'une vidéo. Les captures d'écran devraient suffire pour les problèmes de Contenu ou Visuels.
Exigences générales des pièces jointes
De nouvelles pièces jointes doivent être créées pour chaque rapport de bogue ou reproduction.
Il est interdit de copier des pièces jointes d'autres rapports de bogue ou reproductions.
Les pièces jointes doivent montrer toutes les informations pertinentes du bogue pour servir de preuve.
Toutes les informations pertinentes doivent être affichées en anglais (ou optionnellement en allemand si la langue du rapport de bogue est l'allemand), par exemple la date, l'heure, les informations système et les messages d'erreur.
Tu devrais sélectionner seulement un appareil ou navigateur quand tu signales le bogue, et télécharger seulement une pièce jointe pour celui-ci. Si tu peux reproduire le bogue sur d'autres appareils ou navigateurs, mentionne ceci dans ton Résultat actuel.
Ne montre aucune information sur d'autres clients Test IO qui peut être liée à Test IO (par exemple emails d'invitation ou noms d'onglets de navigateur). Montrer les applications installées d'autres clients est autorisé.
Ne montre aucune information personnelle ou données non professionnelles telles que photos, vidéos ou suggestions de mots incorrects de correction automatique. Rappelle-toi que tes pièces jointes seront disponibles aux autres testeurs, au personnel de test IO et au client donc fais attention à ce que tu montres dessus.
Pour les tests de sites web, le champ URL doit être visible sur les pièces jointes.
La résolution doit être assez élevée pour que le texte et les éléments puissent être facilement identifiés.
Enregistre toujours ton écran entier.
Un journal de plantage est obligatoire pour les rapports de bogue et reproductions positives de plantages d'application. La vidéo qui documente le plantage doit correspondre au journal de plantage joint, c'est-à-dire que les timings doivent être cohérents.
Règles spécifiques de Date et Heure:
La date et l'heure actuelles doivent être visibles dans les pièces jointes.
Quand tu prouves un bogue via une capture d'écran sur un appareil mobile, une seconde capture d'écran montrant la date et l'heure doit être téléchargée (la charge de batterie et l'heure doivent correspondre avec la première capture d'écran).
La date peut être dans n'importe quel format de date commun, par exemple JJ/MM ou MM/JJ, en anglais (ou optionnellement en allemand si la langue du rapport de bogue est l'allemand).
L'heure devrait être dans un format 24 heures, ou si tu utilises un format 12 heures, assure-toi d'utiliser le format AM/PM.
En affichant la date actuelle sur ta pièce jointe, tu prouves que tu l'as enregistrée à cette date. La liste suivante suggère où trouver la date:
Windows: Afficher la barre des tâches ou faire apparaître le calendrier
Mac: Afficher l'icône calendrier dans le Dock ou la barre de menu
iOS & Android: Glisse vers le bas le centre de notifications au début de ton enregistrement.
Informations supplémentaires: How-to-Geek.
Que doit inclure une capture d'écran ?
Règles spécifiques aux captures d'écran:
La capture d'écran doit être au format de fichier JPG ou PNG.
Surligne le bogue sur ta capture d'écran.
Nous recommandons les outils d'enregistrement et meilleures pratiques dans l'article suivant: Captures d'écran.
Alors que les erreurs les plus communes, tu peux les voir dans l'article suivant: Erreurs communes dans les Pièces jointes.
Que doit inclure un screencast ?
Les screencasts devraient être aussi courts que possible mais aussi longs que nécessaire. Cela signifie que tu devrais laisser de côté les étapes qui ne causent pas le bogue. Par exemple, quand le bouton "Ajouter au panier" sur une page de détail de produit d'une boutique en ligne est défectueux, il est généralement non pertinent de savoir comment tu as navigué dans la boutique en ligne pour atteindre la page de détail du produit. La dernière étape de navigation, l'étape qui déclenche le bogue, et le bogue lui-même sont généralement pertinents.
Exemple 1: Bogue sur le site web, testé sur un appareil Desktop
Étapes pour produire un screencast:
Va à la page où le bogue se produit.
Démarre ton enregistrement.
Actualise la page.
Effectue l'action qui déclenche le bogue.
Attends jusqu'à ce que le bogue se produise.
Arrête l'enregistrement.
Exemple 2: Bogue dans l'application, testé sur l'appareil mobile
Étapes pour produire le screencast:
Lance l'application et va à la page où seulement une étape de navigation supplémentaire est nécessaire pour atteindre la page où le bogue se produit.
Démarre ton enregistrement.
Glisse vers le bas le centre de notifications pour montrer la date actuelle pendant quelques secondes.
Effectue la dernière étape de navigation pour atteindre la bonne page.
Effectue l'action qui déclenche le bogue.
Attends jusqu'à ce que le bogue se produise.
Arrête l'enregistrement.
Les chefs d'équipe pourraient t'envoyer une demande d'information demandant un enregistrement externe ou supplémentaire. Ceci est fait pour obtenir une meilleure compréhension du bogue ou en cas de doute dû au fait que le bogue n'est pas reproductible.
Règles spécifiques aux screencasts:
Les screencasts doivent avoir le format de fichier MP4.
La taille maximale de la pièce jointe est de 25 MB.
Le temps maximal pour un screencast est de 60 secondes pour les Rapports de Bogue sauf si ton bogue nécessite de montrer un processus de chargement ou de longues saisies manuelles nécessaires.
Le temps maximal pour un screencast est de 15 secondes pour les pièces jointes de Reproductions et User Stories puisque tu dois seulement montrer la dernière action qui a déclenché le bogue.
Tes clics/taps/touches et l'icône de souris doivent être visibles (seulement requis pour les enregistrements Android et desktop).
Fais ton enregistrement d'un coup. Tu ne devrais pas faire de pause, ni couper des parties au milieu. Si ton screencast est trop long et tu veux l'éditer, coupe seulement le début ou la fin du fichier.
Augmenter la vitesse de ton screencast n'est pas autorisé. Si tu as enregistré plus que le temps autorisé, vérifie si tu n'as pas montré d'étapes inutiles de ton screencast.
N'enregistre aucun bruit (bébé qui crie, conversations, TV, musique, animaux, etc.).
Nous recommandons les outils d'enregistrement et meilleures pratiques dans l'article suivant: Enregistrement.
Alors que les erreurs les plus communes, tu peux les voir dans l'article suivant: Erreurs communes dans les Pièces jointes.
Règles spécifiques aux screencasts pour appareils de Streaming:
Enregistre toujours ton écran de TV entier.
Le screencast devrait avoir une haute résolution et une bonne qualité.
La lumière ambiante ne devrait pas être sombre.
Ta télécommande TV doit être visible dans le screencast. De plus, la télécommande doit être entièrement et clairement visible.
La date et l'heure actuelles doivent être montrées dans la pièce jointe. Tu peux montrer la date actuelle sur la TV elle-même, ou sur un appareil externe tel qu'un PC, téléphone ou tablette.
Pour les Rapports de Bogue, le temps maximal pour un screencast est de 60 secondes, tandis que pour les Reproductions de Bogue et Pièces jointes User Story, le temps maximal est de 15 secondes.
N'enregistre aucun bruit (bébé qui crie, conversations, TV, musique, animaux, etc.).
Le screencast devrait toujours avoir l'air professionnel, n'enregistre pas tes jambes, un meuble TV en désordre, ou similaire.
Comment enregistrer un screencast de Bogues de Clavier?
Parfois il y a des bogues produits lors de l'interaction avec des sites web en utilisant les touches du clavier de l'ordinateur.
Quand c'est le cas, et parce que nous devons montrer l'action qui déclenche le bogue sur le screencast, montrer la saisie clavier est obligatoire.
Voici un excellent exemple de comment créer un screencast montrant la saisie clavier:
Maîtriser les pièces jointes screencast pour tous les appareils
Flouter les Informations Privées sur les Pièces jointes
Pour protéger tes informations privées, telles que marque-pages, noms de compte, ou emails stockés, d'être visibles sur les onglets de navigateur, tu peux suivre cette technique simple de les flouter. Cependant, pour un processus de signalement de bogue plus efficace, il est recommandé d'utiliser une fenêtre de navigateur dédiée à des fins de test, comme démontré dans l'exemple ci-dessous qui ne montre aucun onglet de navigateur inutile ouvert ou marque-pages visibles.
Si tu dois inclure des informations privées dans tes pièces jointes mais ne veux pas qu'elles soient visibles, tu peux suivre cet exemple pour les cacher professionnellement ; note que les noms des onglets du navigateur qui pourraient montrer des adresses email, noms d'utilisateur, et marque-pages sont cachés.
Il est important de noter que l'URL devrait toujours être visible, et les éléments du site web ne devraient pas être obstrués.
Pour des raisons professionnelles, il est crucial d'éviter les méthodes dessinées à la main ou approximatives lors de la couverture d'informations sur tes pièces jointes, comme montré dans l'exemple ci-dessous: