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

有谁知道一个好办法，让用户写一个半体面（读：有用的）错误报告？

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

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

其实不是很有用。

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

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

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

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

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

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

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

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

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

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

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

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

• 错误编写指南 -Mozilla MDN文章
• 如何编写适当的错误 -Mozilla QMO文章
• 如何编写有用的错误报告 -Sun SDN文章

特别是（从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。例如：窗口应向下滚动。应选择滚动内容。或者，至少，应用程序不应崩溃。

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

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

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

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

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

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

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

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