如何报告 Bug
准备工作
在您报告 Bug 之前,请确保您已完成以下步骤
- 更新到当前版本。旧版本的报告将被忽略。
- 查看来自 /trunk/ 的 Changelog 文件,看看您的 Bug 是否已被修复。
- 如果可能,更新到最新的每夜构建版本,看看 Bug 是否仍然存在。您可以在我们的下载页面上找到每夜构建版本的链接。
- 查看邮件列表存档。也许其他人已经报告了您看到的相同 Bug,如果是这样,该 Bug 可能已被修复。
如何编写 Bug 报告
TortoiseSVN 有大量的用户。实际开发 TortoiseSVN 的人要少得多。积极修复用户报告的 Bug 的人甚至更少。
这对您这位有抱负的 Bug 报告者意味着什么?为了引起这些少数志愿者的注意,您需要认真对待一些关于如何报告 Bug 的技巧,以便他们能够并且将会帮助您。
请特别注意上面用粗体字表示的单词。将要帮助您处理您报告的 Bug 的人是志愿者。您不仅没有付费请他们帮助您,而且也没有其他人付费。所以,对他们友善一点。
除了这条黄金法则之外,以下是一些关于如何使您的 Bug 报告更好的额外技巧,以便有人能够帮助您。
基本要素:您做了什么,您想要发生什么,以及实际发生了什么。
这些是 Bug 报告的三个基本要素。您需要确切地告诉我们您做了什么(例如,“我右键单击了 ‘制作开心乐园餐’”),您期望发生什么(继续这个例子,“我期望 TortoiseSVN 为我提供一份包含汉堡和洋葱圈的开心乐园餐”),以及实际发生了什么(“它给了我一份包含炸薯条的开心乐园餐。”)。
是的,这个例子很傻。但是,如果您的 Bug 报告只是简单地说“make_happy_meal 函数不起作用”,您很可能会收到回复说“对我来说工作正常”,因为我们无法猜测您期望发生什么。通过提供所有信息,您可能会收到类似“那是因为开心乐园餐里不能有洋葱圈,你只能有炸薯条或波浪薯条。”的回复。通过告诉我们您要求什么,您期望得到什么,以及您实际得到什么,我们不必猜测您的意思。
每个 Bug 报告只报告一个问题
如果您遇到了两个看起来不相关的 Bug,请为每个 Bug 创建一个新的 Bug 报告。这使得不同的人更容易帮助处理不同的 Bug。将报告发送到哪里?
Bug 报告应在我们的论坛上报告。