让用户编写体面而有用的错误报告


32

有谁知道一个好办法,让用户写一个半体面(读:有用的错误报告

我们想提出一些对大多数用户有意义的内容(易于阅读和理解),同时也向开发人员提供有用的信息。

当我单击蓝色按钮时,它不起作用!啊,我刚丢了一个星期的工作……努力工作。

其实不是很有用。

我开始修正列表,但考虑与你们一起检查是否已经存在类似的方法。


2
我可以理解投票赞成关闭程序员,但是话题不对吗?程序员站点上的错误报告?
Rook 2012年

1
有关系吗?他们仍然会编写错误的错误报告。您通常需要做的是以某种方式与用户沟通。
David Thornley,2012年

@DavidThornley-我们属于特定行业。我与大多数用户从未交流过,几个月后也没有得到这些报告。不要问
Rook

3
将报告机制构建到您的应用程序中,以便用户可以单击按钮,添加评论并由应用程序附加适当的状态。“现在,请单击

3
让我知道是否找到答案。我很难从测试人员那里获得有用的错误报告,不要介意用户。
克里斯托弗·普罗沃斯特

Answers:


16

让用户编写体面和有用的错误报告的最有效方法是

  1. 让他们在线查看报告。
    [系统]感谢您的举报,您可以在此处找到请求的状态:...
  2. ...以及来自指定工程师的评估和意见...
    [Engineer]请求被拒绝,因为缺少以下详细信息:...
  3. ...可以选择修改/改进他们的报告。
    [用户]添加了请求的详细信息,请重新评估:...

我会声称这是唯一有效的方法。

面对现实,有效编写错误报告的技能只有经验。需要学习以获取经验。学习包括练习,获得反馈和改进。

用户可编辑的在线错误报告是教会用户改进的最有效方法。

  • 上面的替代方法是1)与用户安排面对面的学习会议(是的,尤其是在全球有成千上万的情况下)。或者2)通过电话向他们解释事情(“看,如果您只能看到您在第225行写的废话……”)。还有什么?哦3)通过电子邮件,请确保“在您两个月前发送给我们的邮件中,您提到了……不,不是那封电子邮件,您今天给我们发送了五封电子邮件,其中三封以主题为准Re:蓝色按钮单击,查看第二个是附加了10Mb屏幕截图的那个……什么?您找不到它吗?”

27

我认为,更重要的是使用该错误来建立与用户的持续联系。编写和理解错误报告是一种技能,我的建议是使用户尽可能容易地进行首次联系,然后根据需要逐步使其反馈具有更多价值。

例如,只需获取用户的电子邮件,然后给他们一个纯文本字段即可完成以下操作:

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

收到电子邮件后,请进行自动回复以选择两次以确认他们已提交错误,您已收到该错误,并且可以对该错误进行后续跟踪。


2
好答案。简洁而善于交流。我将把这些信息偷偷拿给别人解释。
埃里克·迪特里希

这也应该是SO问题开始的模板。
Cody Piersall 2014年

5
我确实按下了蓝色按钮,并期望一切正常,但是什么也没发生。:D
Songo 2015年

“我做了_____,并期望______发生,但是______发生了。” 我在生产/质量保证/测试环境上使用的软件版本是______。
kubanczyk 2015年

10

您可以考虑从Mozilla和Sun就此主题提出一些想法:

特别是(从Mozilla“如何编写适当的错误”页面中):

错误报告的概述

摘要:您如何用少于60个字符来描述错误?它应该快速且唯一地标识错误报告并说明问题,而不是建议的解决方案。

:“取消文件复制对话框会使文件管理器崩溃”

不好:“软件崩溃”

错误:“浏览器应与我的网站配合使用”

组件:软件存在于哪个子部分中?此字段是提交任何错误报告的要求。单击“组件”一词以查看每个组件的描述。如果似乎不合适,请突出显示“常规”部分。

OS:在哪个操作系统(OS)上找到它?(例如Linux,Windows XP,Mac OSX。)示例:“如果您知道错误发生在多种类型的操作系统上,请选择“全部”。如果您的操作系统未列出,请选择“其他”。

描述:您的问题报告的详细信息,包括:

- 概述:这是摘要的较大详细重述。一个例子是:“拖动选择任何页面会使NSGetFactory函数中的Mac版本崩溃”。

- 生成ID:要找到此链接,请通过位置栏转到“关于:”页面,或者,如果您具有MozQA的Nightly Tester Tools扩展程序,则请转到“工具” |“构建”。Nightly Tester Tools,然后选择包含构建ID输出的选项。它看起来应该像这样:“ Mozilla / 5.0(Macintosh; U; Intel Mac OS X 10.5; en-US; rv:1.9.1b3)Gecko / 20090305 Firefox / 3.1b3”。

- 其他构建和平台:该错误是否发生在其他平台(或浏览器,如果适用)上。它看起来应该是这样的:“在Mozilla / 5.0(Macintosh; U; Intel Mac OS X 10.5; en-US; rv:1.9.1b3)Gecko / 20081107 Firefox / 3.1b2上不会发生”。

重现步骤:最小化,易于遵循的步骤将触发该错误。如果有必要,请确保包括任何特殊的设置步骤。一个很好的示例如下所示:1)查看任何网页。(我使用了默认的示例页面 http://www.google.com/)。2)拖动选择页面。具体来说,在按住鼠标按钮的同时,将鼠标指针从浏览器内容区域中的任何点向下拖动到浏览器内容区域的底部。

实际结果:执行上述步骤后,应用程序做了什么。一个例子是:应用程序崩溃。

预期结果:该应用程序应该执行的操作是没有该bug。例如:窗口应向下滚动。应选择滚动内容。或者,至少,应用程序不应崩溃。


10
我真的不明白为什么这么多选票。问题不是“如何编写体面的错误报告?” 但“如何使用户编写体面的错误报告”。
塔玛斯·塞莱伊(TamásSzelei)2012年

8
这些资源主要针对技术人员。Mozilla也是为我们带来Bugzilla的组织。我不是说的Bugzilla是坏的,但它已经取得工程师工程师:这真的不是一个最终用户工具,在所有
约阿希姆·绍尔

3
必须同意@fish。我们可以为测试人员提供世界上所有的指南-不会使他们实际上产生有用的错误报告。我所说的是举报错误的人员,如果我们不能按照准则来激励他们,我们对于实际的用户将完全没有希望。我们发现唯一有效的方法是主动关闭“无用”的错误报告,将其视为“信息不足”,然后他们很快就收到了消息。不过,我不建议外部用户使用它:-)
HappyCat 2012年

3
我根本没有在争论该帖子的有用性(确实那里有很多好的资源),但这并不能回答问题,我认为投票政策是基于此的(我可能是错误的)。
塔玛斯·塞莱伊(TamásSzelei)2012年

1
我就是这种针对的人,甚至我无法坐下来阅读全部内容。是什么让您认为用户会去?
塔克鲁伊2012年

4

还有如何有效的报告Bug由Simon泰胜。它确实很好地解释了事情,使经验不足的用户易于理解。但是不利的是,这是很多文字。如果您有用户尝试报告问题,但未能解释问题,通常将无法说服他阅读所有内容。


4

您可以向用户提出易于理解和易于回答的问题,以期获得有用的报告。

例如,“您在此错误之前最后采取的行动是什么?”,“您试图在此错误之前尝试...吗?”。

没有用户会向您编写错误报告,例如:“我的视频驱动程序不是最新的。您的图形库可能与旧的图形驱动程序不兼容。”


3

假设用户群是您编写的软件有问题的最终用户。

成为熟练的软件工程师或测试专业人​​员不是用户的工作,也不应该期望他们这样做。您的用户是一般人,他们正确地期望该软件“正常运行”。如果没有,他们会报告他们认为需要引起注意的所有内容。您无法更改,也不应尝试更改。坚持要求专业人员做出任何报告的尝试都将导致错误报告的丢失,并且客户-“我对该软件有问题,但是他们没有帮助我,而是把所有的信息都填写了下来。毫无用处的形式,对我来说毫无价值。我会去找一些真正有效的软件。”

即这不是他们的工作.....

如果您需要良好的错误报告,请雇用专业人员来查找您的错误。如果您作为软件开发人员不愿意与客户打交道,请雇用可以的人。


1
我不认为OP在说他们不想与用户打交道。我认为OP表示他们无法根据错误报告“崩溃”真正修复任何问题。OP希望有一种方法可以最大程度地利用抱怨的用户,以便OP可以真正解决问题。
迈克尔·科恩

1
我的观点是,如果“崩溃”是从用户的角度来看发生的事情。当我将汽车送去维修时,他不希望我给他提供专业的详细故障诊断报告-他问我一些问题,以帮助他利用自己的专业知识来诊断问题。例如,一次拜访我的问题是“天气寒冷时停滞,但天气炎热时则可以”,一些经过深思熟虑的问题(是的,没有答案)后来他相当确定(事实证明是正确的),这是有问题的温度计。我们的工作是提出问题,并给出“不是”的答案。
mattnz
By using our site, you acknowledge that you have read and understand our Cookie Policy and Privacy Policy.
Licensed under cc by-sa 3.0 with attribution required.