Amener les utilisateurs à rédiger des rapports de bogues décents et utiles

32

Quelqu'un connaît-il un bon moyen d' amener les utilisateurs à rédiger un rapport de bogue semi-décent (lire: utile ) ?

Nous voulions mettre en place quelque chose qui aurait du sens pour la plupart des utilisateurs (être facile à lire et à comprendre), tout en fournissant également des informations utiles aux développeurs.

Cela ne fonctionne pas lorsque je clique sur le bouton bleu! Ahhh, je viens de perdre une semaine de travail ... pour que ça marche.

n'est pas très utile, comme ça.

J'ai commencé à fixer une liste, mais j'ai pensé vérifier avec vous si une méthode similaire existe déjà.

Tour
la source
2
Je pourrais comprendre voter pour la fermeture aux programmeurs, mais hors sujet? Rapports de bugs sur le site d'un programmeur?!
Tour
1
Est-ce que ça importe? Ils écriront quand même de mauvais rapports de bogues. Ce que vous devez généralement faire, c'est communiquer avec les utilisateurs d'une manière ou d'une autre.
David Thornley
@DavidThornley - Nous sommes dans une sorte d'industrie spécifique. Avec la plupart des utilisateurs, je ne communique jamais ou j'obtiens ces rapports quelques mois plus tard. Ne demande pas.
Tour le
3
Intégrez le mécanisme de rapport dans votre application, afin que l'utilisateur puisse cliquer sur un bouton, ajouter un commentaire et avoir l'état approprié attaché par l'application. "Maintenant, s'il vous plaît, cliquez sur l'emplacement sur l'écran où c'est faux" ...
3
Faites-moi savoir si vous trouvez une réponse. J'ai assez de mal à obtenir des rapports de bogues utiles de la part des testeurs, sans parler des utilisateurs.
Kristof Provost

Réponses:

16

Le moyen le plus efficace d'amener les utilisateurs à rédiger des rapports de bogues décents et utiles est

  1. pour leur permettre de voir leurs rapports en ligne ...
    [Système] Merci d'avoir signalé, vous pouvez trouver l'état de votre demande ici: ...
  2. ... ainsi que l' évaluation et les commentaires de l'ingénieur affecté ...
    [Ingénieur] Demande rejetée, car les détails suivants sont manquants: ...
  3. ... avec une option pour modifier / améliorer leur rapport.
    [Utilisateur] Les détails demandés sont ajoutés, veuillez réévaluer: ...

J'irais jusqu'à prétendre que c'est le seul moyen efficace.

Avouons-le, la compétence pour rédiger efficacement des rapports de bogues ne vient que de l'expérience. Il faut apprendre à acquérir de l'expérience. L'apprentissage implique de pratiquer, d'obtenir des commentaires et de s'améliorer.

Les rapports de bogues en ligne modifiables par l'utilisateur sont le moyen le plus efficace d' apprendre aux utilisateurs à s'améliorer .

  • Les options alternatives à ce qui précède sont 1) pour organiser des sessions d'apprentissage en face à face avec les utilisateurs (oui, bien sûr, surtout quand il y en a des milliers dans le monde). Ou 2) expliquez-leur les choses par téléphone ("regardez, si vous ne pouviez voir que les conneries que vous avez écrites à la ligne 225 ..."). Quoi d'autre? Oh 3) par e-mail, bien sûr "dans le courrier que vous nous avez envoyé il y a deux mois, vous avez mentionné ... non pas cet e-mail, vous nous avez envoyé cinq e-mails ce jour-là, trois d'entre eux avaient pour sujet Re: cliquez sur le bouton bleu , regardez le deuxième, celui avec une capture d'écran de 10 Mo attaché à lui ... quoi? vous ne le trouvez pas? "
moucheron
la source
27

À mon avis, ce qui est plus important, c'est d'utiliser le bogue pour établir un contact permanent significatif avec l'utilisateur. La rédaction et la compréhension des rapports de bogues est une compétence, et mon conseil serait de faciliter le plus possible la prise de contact par l'utilisateur, puis de faire progressivement ses commentaires plus utiles au besoin.

Par exemple, récupérez simplement l'e-mail de l'utilisateur et donnez-lui un champ en texte brut avec le texte suivant à compléter:

"I did _____ , and expected ______ to happen, but ______ happened instead."

Après avoir reçu l'e-mail, effectuez une réponse automatique pour obtenir une double option pour confirmer qu'ils ont soumis le bogue, vous l'avez reçu et le suivi du bogue est correct.

gaffes
la source
2
Très bonne réponse. Succinct et communicatif. Je vais chaparder cela à l'avenir pour expliquer aux gens.
Erik Dietrich
Cela devrait également être le modèle avec lequel les questions SO commencent.
Cody Piersall
5
J'ai appuyé sur le bouton bleu et je m'attendais à ce que les choses fonctionnent , mais rien ne s'est produit à la place. : D
Songo
"J'ai fait _____, et je m'attendais à ce que ______ se produise, mais ______ s'est produit à la place." J'utilisais le logiciel ______ version _____ sur l'environnement de production / qa / test.
kubanczyk du
10

Vous pourriez envisager de prendre quelques idées de Mozilla et Sun sur ce sujet:

En particulier (à partir de la page Mozilla "Comment écrire un bug correct"):

Aperçu général d'un rapport de bogue

Résumé : Comment décririez-vous le bug en moins de 60 caractères? Il doit identifier rapidement et uniquement un rapport de bogue ainsi qu'expliquer le problème, et non la solution que vous avez suggérée.

Bon : «L'annulation d'une boîte de dialogue de copie de fichier bloque le gestionnaire de fichiers»

Mauvais : "Le logiciel plante"

Mauvais : "Le navigateur devrait fonctionner avec mon site Web"

Composant : Dans quelle sous-partie du logiciel existe-t-il? Ce champ est obligatoire pour soumettre un rapport de bogue. Cliquez sur le mot «Composant» pour voir une description de chaque composant. Si aucune ne semble appropriée, mettez en surbrillance la composante «Général».

OS : Sur quel système d'exploitation (OS) l'avez-vous trouvé? (par exemple Linux, Windows XP, Mac OS X.) Exemple: «Si vous savez que le bogue se produit sur plusieurs types de système d'exploitation, choisissez« Tous ». Si votre système d'exploitation n'est pas répertorié, choisissez Autre ».

Description : les détails de votre rapport de problème, notamment:

- Vue d'ensemble : il s'agit d'un retraitement détaillé plus large du résumé. Un exemple serait: "Glisser-sélectionner n'importe quelle page plante les builds Mac dans la fonction NSGetFactory".

- Build Id : pour le trouver, allez sur la page «à propos de» via la barre d'emplacement ou, si vous avez l'extension Nightly Tester Tools de MozQA, allez dans Outils | Nightly Tester Tools et sélectionnez l'option qui contient la sortie de l'ID de build. Il devrait ressembler à ceci: "Mozilla / 5.0 (Macintosh; U; Intel Mac OS X 10.5; en-US; rv: 1.9.1b3) Gecko / 20090305 Firefox / 3.1b3".

- Constructions et plates-formes supplémentaires : si le bogue se produit ou non sur d'autres plates-formes (ou navigateurs, le cas échéant). Il devrait ressembler à ceci: "N'existe pas sur Mozilla / 5.0 (Macintosh; U; Intel Mac OS X 10.5; en-US; rv: 1.9.1b3) Gecko / 20081107 Firefox / 3.1b2".

Étapes à reproduire : étapes minimisées et faciles à suivre qui déclencheront le bogue. S'ils sont nécessaires, assurez-vous d'inclure toutes les étapes de configuration spéciales. Un bon exemple de ceci ressemblerait à ceci: 1) Affichez n'importe quelle page Web. (J'ai utilisé l'exemple de page par défaut, http://www.google.com/ ). 2) Faites glisser-sélectionnez la page. Plus précisément, tout en maintenant le bouton de la souris enfoncé, faites glisser le pointeur de la souris vers le bas à partir de n'importe quel point de la région de contenu du navigateur vers le bas de la région de contenu du navigateur.

Résultats réels : ce que l'application a fait après avoir effectué les étapes ci-dessus, par exemple: l'application s'est bloquée.

Résultats attendus : ce que l'application aurait dû faire si le bogue n'était pas présent, par exemple: la fenêtre devrait défiler vers le bas. Le contenu défilé doit être sélectionné. Ou, au moins, l'application ne devrait pas planter.

Brian Snow
la source
10
Je ne comprends pas vraiment pourquoi cela a obtenu autant de votes. La question n'est pas "comment écrire un rapport de bogue décent?" mais "comment amener les utilisateurs à écrire un rapport de bogue décent".
Tamás Szelei
8
Ces ressources sont principalement destinées aux techniciens. Mozilla est également l'organisation qui nous a apporté Bugzilla. Je ne dis pas que Bugzilla est mauvais, mais il a été fait par des ingénieurs pour les ingénieurs: Il est vraiment pas un outil utilisateur final du tout .
Joachim Sauer
3
Je dois être d'accord avec @fish. Nous pouvons donner à nos testeurs toutes les directives dans le monde - ne les rend pas réellement produire des rapports de bogues. Et je parle des gens qui ont pour tâche de signaler les bugs - si nous ne pouvons pas les motiver avec des directives, nous n'avons aucun espoir du tout avec les utilisateurs réels. La seule chose que nous avons trouvée efficace a été de fermer activement les rapports de bogues "inutiles" car "pas assez d'informations" - ils ont alors reçu le message assez rapidement. Je ne le conseille cependant pas aux utilisateurs externes :-)
HappyCat
3
Je ne discute pas du tout de l'utilité du poste (assez bonnes ressources là-bas, vraiment) mais cela ne répond pas à la question, et je pense que la politique de vote est basée sur cela (je peux me tromper).
Tamás Szelei
1
Je suis le genre de personne que cela visait et même je ne pouvais pas m'asseoir en lisant le tout. Qu'est-ce qui vous fait penser aux utilisateurs?
Tacroy
4

Il y a Comment rapporter des bogues efficacement par Simon Tatham. Il explique bien les choses, pour le rendre facile à comprendre pour les utilisateurs moins expérimentés. Cependant, l'inconvénient est qu'il s'agit d'un peu de texte. Lorsqu'un utilisateur essaie de signaler un problème mais ne parvient pas à l'expliquer, vous ne pourrez généralement pas le convaincre de lire tout cela.

Wladimir Palant
la source
4

Vous pouvez poser des questions faciles à comprendre et faciles à répondre aux utilisateurs pour qu'ils s'attendent à des rapports utiles.

Par exemple, "Quelle a été votre dernière action avant cette erreur?", "Avez-vous essayé de ... juste avant cette erreur?".

Aucun utilisateur ne vous rédigerait un rapport de bug comme: "Mon pilote vidéo n'est pas à jour. Votre bibliothèque graphique n'est peut-être pas compatible avec les anciens pilotes graphiques."

Mert Akcakaya
la source
3

En supposant que la base d'utilisateurs est constituée d'utilisateurs finaux qui ont eu un problème avec le logiciel que vous avez écrit ....

Ce n'est pas le travail de vos utilisateurs de devenir un ingénieur logiciel compétent ou un professionnel des tests, et vous ne devriez pas vous y attendre. Vos utilisateurs sont des gens ordinaires qui s'attendent à juste titre à ce que le logiciel "fonctionne tout simplement". Si ce n'est pas le cas, ils rapporteront tout ce qu'ils pensent qu'ils veulent pour attirer votre attention. Vous ne pouvez pas changer cela et ne devriez pas essayer de le faire. Toute tentative d'insister sur le type de rapports qu'un professionnel est censé faire entraînera la perte du rapport de bogue, et le client - "J'ai eu un problème avec ce logiciel, mais au lieu de m'aider, ils ont été remplis sortes de formes inutiles qui ne signifient rien et n'ont aucune valeur pour moi. Je vais trouver des logiciels qui fonctionnent réellement. ".

ce n'est pas leur travail .....

Si vous voulez de bons rapports de bogues, faites appel à des professionnels pour trouver vos bogues. Si vous, en tant que développeur de logiciels, ne vous inquiétez pas de traiter avec des clients, employez quelqu'un qui le peut.

Mattnz
la source
1
Je ne pense pas que le PO dise qu'il ne veut pas traiter avec les utilisateurs. Je pense que l'OP dit qu'ils ne peuvent pas vraiment réparer quoi que ce soit basé sur le rapport de bogue «il s'est écrasé». L'OP veut un moyen de tirer le meilleur parti des utilisateurs qui se plaignent, afin que l'OP puisse réellement résoudre le problème.
Michael Kohne
1
Mon point est que si "ça plante" c'est ce qui se passe du point de vue de l'utilisateur. Lorsque j'emmène ma voiture chez un mécanicien, il ne s'attend pas à ce que je lui donne un rapport de diagnostic expert et détaillé de ce qui ne va pas - il me pose des questions pour l'aider à utiliser son expertise pour diagnostiquer le problème. Par exemple, lors d'une visite, mon problème était "Il cale quand il fait froid, mais ça va quand il fait chaud", quelques questions mûrement réfléchies (avec oui, pas de réponse) plus tard, il était assez sûr (et s'est avéré correct) que c'était un défaut thermomètre. Notre travail consiste à poser les questions, encadrées pour donner des réponses oui non.
mattnz