Conseguir que os usuários escrevam relatórios de erros úteis e decentes

32

Alguém conhece uma boa maneira de fazer com que os usuários escrevam um relatório de erro semi-decente (leia-se: útil ) ?

Queríamos colocar algo que faria sentido para a maioria dos usuários (seja fácil de ler e entender), mas também fornecer informações úteis para os desenvolvedores.

Não funciona quando clico no botão azul! Ahhh, acabei de perder uma semana de trabalho ... faça funcionar.

não é muito útil, como é.

Comecei a corrigir uma lista, mas pensei em verificar com vocês, se já existe um método semelhante.

Torre
fonte
2
Eu conseguia entender o voto para fechar para programadores, mas offtopic? Relatórios de bugs no site de um programador ?!
Rook
1
Isso importa? Eles escreverão relatórios de erros ruins de qualquer maneira. O que você normalmente precisa fazer é se comunicar com os usuários de alguma forma.
David Thornley
@DavidThornley - Estamos em um tipo de setor específico. Com a maioria dos usuários, nunca me comunico ou recebo esses relatórios alguns meses depois. Não pergunte.
Rook
3
Crie o mecanismo de relatório no seu aplicativo, para que o usuário possa clicar em um botão, adicionar um comentário e ter o estado apropriado anexado pelo aplicativo. "Agora, por favor, clique no local na tela onde está errado" ...
3
Deixe-me saber se você encontrar uma resposta. Estou tendo problemas suficientes para obter relatórios de erros úteis dos testadores, não importa os usuários.
Kristof Provost

Respostas:

16

A maneira mais eficaz de fazer com que os usuários escrevam relatórios de erros decentes e úteis é

  1. para permitir que eles vejam seus relatórios on-line ...
    [Sistema] Obrigado por reportar, você pode encontrar o status da sua solicitação aqui: ...
  2. ... junto com a avaliação e os comentários do engenheiro designado ...
    [Engenheiro] Pedido rejeitado, pois os seguintes detalhes estão ausentes: ...
  3. ... com uma opção para editar / melhorar o relatório.
    [Usuário] Os detalhes solicitados foram adicionados, reavalie: ...

Eu chegaria ao ponto de afirmar que é a única maneira eficaz.

Vamos ser sinceros, a habilidade de escrever relatórios de erros efetivamente vem apenas com a experiência. É preciso aprender a ganhar experiência. Aprender envolve praticar, obter feedback e melhorar.

Os relatórios de erros on-line editáveis ​​pelo usuário são a maneira mais eficiente de ensinar os usuários a melhorar .

  • As opções alternativas acima são 1) para organizar sessões de aprendizado presencial com os usuários (sim, claro, especialmente quando existem milhares deles espalhados pelo mundo). Ou 2) explique as coisas pelo telefone ("veja, se você pudesse ver a porcaria que escreveu na linha 225 ..."). O quê mais? Oh 3) por e-mail, com certeza "no e-mail que você nos enviou há dois meses, você mencionou ... não, não esse e-mail, você nos enviou cinco e-mails hoje, três deles com assunto Re: clique no botão azul , olhe o segundo, aquele com captura de tela de 10 Mb anexado a ele ... o quê? você não consegue encontrá-lo? "
mosquito
fonte
27

Na minha opinião, o mais importante é usar o bug para estabelecer um contato significativo com o usuário. Escrever e entender relatórios de erros é uma habilidade, e meu conselho seria tornar o mais fácil possível para o usuário fazer o primeiro contato e, em seguida, aumentar progressivamente seus comentários, com mais valor, conforme necessário.

Por exemplo, obtenha o email do usuário e forneça um campo de texto sem formatação com o seguinte texto para concluir:

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

Depois de receber o email, faça uma resposta automática para confirmar se eles enviaram o bug, você o recebeu e o acompanhamento do bug está correto.

erros
fonte
2
Ótima resposta. Sucinto e comunicativo. Eu vou furtar isso daqui para frente por explicar para as pessoas.
Erik Dietrich
Esse também deve ser o modelo com o qual as perguntas do SO começam.
Cody Piersall
5
Eu fiz prima o botão azul , e espera que as coisas funcionem , mas nada aconteceu em seu lugar. : D
Songo 11/12
"Eu fiz _____ e esperava que ______ acontecesse, mas ______ aconteceu." Eu estava usando o software ______ versão _____ no ambiente de produção / qa / teste.
Kubanczyk
10

Você pode considerar usar algumas idéias da Mozilla e da Sun sobre este tópico:

Particularmente (na página Mozilla "Como escrever um bug adequado"):

Esboço geral de um relatório de bug

Resumo : como você descreveria o erro com menos de 60 caracteres? Ele deve identificar rápida e exclusivamente um relatório de erro, além de explicar o problema, não a solução sugerida.

Bom : “O cancelamento da caixa de diálogo Cópia de arquivo trava o Gerenciador de arquivos”

Ruim : "Falhas de software"

Ruim : “O navegador deve funcionar com meu site”

Componente : Em qual subparte do software ele existe? Este campo é um requisito para enviar qualquer relatório de bug. Clique na palavra "Componente" para ver uma descrição de cada componente. Se nenhum parecer apropriado, realce o componente "Geral".

SO : Em qual sistema operacional (SO) você o encontrou? (por exemplo, Linux, Windows XP, Mac OS X.) Exemplo: “Se você souber que o bug ocorre em mais de um tipo de sistema operacional, escolha“ Todos ”. Se o seu sistema operacional não estiver listado, escolha Outro ”.

Descrição : os detalhes do seu relatório de problemas, incluindo:

- Visão geral : esta é uma atualização detalhada mais detalhada do resumo. Um exemplo seria: “A seleção de arrastar qualquer página trava, compilada pelo Mac, na função NSGetFactory”.

- ID da compilação : para encontrar isso, vá para a página “about:” através da barra de localização ou, se você tiver a extensão Nightly Tester Tools do MozQA, vá para Tools | Ferramentas do Nightly Tester e selecione a opção que contém a saída do ID da compilação. Ele deve ter a seguinte aparência: "Mozilla / 5.0 (Macintosh; U; Intel Mac OS X 10.5; en-US; rv: 1.9.1b3) Gecko / 20090305 Firefox / 3.1b3".

- Construções e plataformas adicionais : se o bug ocorre ou não em outras plataformas (ou navegadores, se aplicável). Deve ter a seguinte aparência: "Não ocorre no Mozilla / 5.0 (Macintosh; U; Intel Mac OS X 10.5; pt-BR; rv: 1.9.1b3) Gecko / 20081107 Firefox / 3.1b2".

Etapas para reproduzir : Etapas minimizadas e fáceis de seguir que acionarão o bug. Se necessário, inclua etapas especiais de configuração. Um bom exemplo disso seria o seguinte: 1) Visualize qualquer página da web. (Usei a página de amostra padrão, http://www.google.com/ ). 2) Arraste e selecione a página. Especificamente, enquanto mantém pressionado o botão do mouse, arraste o ponteiro do mouse para baixo de qualquer ponto na região de conteúdo do navegador até a parte inferior da região de conteúdo do navegador.

Resultados reais : o que o aplicativo fez depois de executar as etapas acima. Um exemplo seria: O aplicativo travou.

Resultados esperados : o que o aplicativo deveria ter feito, caso o bug não estivesse presente. Um exemplo seria: A janela deve rolar para baixo. O conteúdo rolado deve ser selecionado. Ou, pelo menos, o aplicativo não deve falhar.

Brian Snow
fonte
10
Eu realmente não entendo por que isso recebeu tantos votos. A questão não é "como escrever um relatório de erro decente?" mas "como fazer com que os usuários escrevam um relatório de erro decente".
Tamás Szelei
8
Esses recursos são direcionados principalmente a pessoas técnicas. A Mozilla também é a organização que nos trouxe o Bugzilla. Não estou dizendo que o Bugzilla é ruim, mas foi feito por engenheiros para engenheiros: não é realmente uma ferramenta para o usuário final .
Joachim Sauer
3
Tem que concordar com @fish. Podemos dar a nossos testadores todas as diretrizes do mundo - não os faz realmente produzir relatórios úteis de erros. E estou falando de pessoas que têm o trabalho de relatar bugs - se não podemos motivá-las com diretrizes, não temos esperança alguma com os usuários reais. A única coisa que consideramos eficaz foi o fechamento ativo de relatórios de erros "inúteis" como "informações insuficientes" - eles receberam a mensagem rapidamente. Eu não aconselho-o para usuários externos embora :-)
happycat
3
Não estou debatendo a utilidade do post (recursos muito bons lá, realmente), mas isso não responde à pergunta, e acho que a política de votação é baseada nisso (posso estar errado).
Tamás Szelei
1
Eu sou o tipo de pessoa a quem isso se destina e nem mesmo eu conseguia ler a coisa toda. O que faz você pensar que os usuários estão indo?
Tacroy
4

como relatar erros de maneira eficaz por Simon Tatham. Explica bem as coisas, facilitando o entendimento para usuários menos experientes. No entanto, a desvantagem é que é um pouco de texto. Quando você tem um usuário tentando relatar um problema, mas falhando em explicá-lo, geralmente não será capaz de convencê-lo a ler tudo isso.

Wladimir Palant
fonte
4

Você pode pedir perguntas fáceis de entender e fáceis de responder aos usuários para que esperem relatórios úteis.

Por exemplo, "Qual foi sua última ação antes deste erro?", "Você tentou ... imediatamente antes deste erro?".

Nenhum usuário escreveria um relatório de erro como: "Meu driver de vídeo não está atualizado. Sua biblioteca de gráficos pode não ser compatível com drivers gráficos antigos".

Mert Akcakaya
fonte
3

Supondo que a base de usuários são usuários finais que tiveram um problema com o software que você escreveu ....

Não é tarefa do usuário se tornar um engenheiro de software ou um profissional de teste proficiente, e você não deve esperar que eles o façam. Seus usuários são pessoas comuns que esperam, com razão, que o software "apenas funcione". Quando isso não acontecer, eles reportarão tudo o que acharem necessário para chamar sua atenção. Você não pode mudar isso e não deve tentar. Qualquer tentativa de insistir no tipo de relatório que um profissional deve fazer resultará na perda do relatório de erro e no cliente - "Eu tive um problema com esse software, mas, em vez de me ajudar, eles devem preencher todos os tipos de formas inúteis que não significam nada e não têm valor para mim. Vou procurar algum software que realmente funcione. ".

ou seja, não é o trabalho deles ...

Se você deseja um bom relatório de erros, contrate profissionais para encontrar seus erros. Se você, como desenvolvedor de software, não pode se incomodar em lidar com clientes, contrate alguém que possa.

mattnz
fonte
1
Eu não acho que o OP esteja dizendo que eles não querem lidar com os usuários. Eu acho que o OP está dizendo que eles realmente não podem consertar nada com base no relatório de erro 'travou'. O OP quer uma maneira de tirar o máximo proveito dos usuários que estão reclamando, para que o OP possa realmente corrigir o problema.
Michael Kohne 18/05
1
O que quero dizer é que, se "travou", é o que acontece da perspectiva do usuário. Quando levo meu carro a um mecânico, ele não espera que eu lhe forneça um relatório de diagnóstico habilmente detalhado do que está errado - ele me faz perguntas para ajudá-lo a usar sua experiência para diagnosticar o problema. Por exemplo, em uma visita, meu problema foi "Ele pára quando está frio, mas tudo bem quando está quente", algumas perguntas bem consideradas (com respostas não sim) mais tarde, ele tinha quase certeza (e estava correto) que estava com defeito termômetro. Nosso trabalho é fazer as perguntas, moldadas para dar respostas sim, não.
mattnz