The Right Way to Report a Bug

The following text is a partial translation of the original English article, performed by ChatGPT (gpt-3.5-turbo) and this Jekyll plugin:

你知道,在Zerocracy上,你要么是程序员,要么是测试人员,我们会为你发现并报告的每个错误进行支付。嗯,并不完全是这样。我们只为项目架构师认为足够好以支付的每个错误报告支付费用。根据政策第29条,架构师的决定是完全主观和无可争议的。我们的一些开发人员认为这不公平,并要求我解释他们如何报告错误以确保得到支付。以下是我非详尽的建议列表。

老实说,关于如何撰写良好的错误报告已经有很多文章写过了。我会尽量避免重复它们。它们大多都说一些合理的事情,比如“具体说明”,“选择一个强势标题”,“避免重复”,还有其他很多。我这里的建议更多是心理层面上的。

保持冷静。不要期望你的所有错误都会被接受并得到支付。其中一些错误可能不会。但这不应该阻止你报告它们。

夸大其词。无论错误有多么小,都要将其描述得好像如果不修复它,整个世界明天就会崩溃一样。当然,他们会根据错误的优先级和严重程度做出自己的决定,但不要帮助他们做出对你不利的决定。

让自己成为受害者。不要只是说“这个类坏了”——这个陈述中没有受害者。所以,无需拯救任何人的生命。这个错误很小——无需支付。相反,说“我无法使用这个类。”将自己描述成一个受害者。或者更好的是,代表一群受害者:“真的没有人能够使用这个类。”

推动他们。如果一个错误报告没有被支付,不要犹豫地询问原因。坚持认为这是一个非常重要的问题,你应该得到支付。如果他们仍然不支付,就忘了它,继续前进。你不能表现得好像它在某种程度上冒犯了你。

展示努力。错误描述必须“丰富”,清楚地展示你在创建错误报告时投入了很多努力。如果只有一行,他们更容易不支付你——他们不会感到任何愧疚。然而,如果它很长,详细,格式良好,并包含多个支持链接,如果他们不支付,他们会感到不好。

保持参与。说一些像“如果你需要,我愿意进一步调查并提供更多细节。”的话。当然,在大多数情况下你不会这样做,但你必须说。这会让人觉得你关心这个错误,并且这个错误来自你的真心。他们怎么能不支付它呢?

显得无私。不要让他们知道你报告这些错误只是为了赚钱。他们无论如何都知道,但还是。看起来你关心项目,真诚地想要帮助。说你担心用户,市场,使命,更大的范围等等。

合并。这可能与我之前提出的错误跟踪原则相悖,但当你的错误很小和表面时,将它们合并。在这种情况下,你有机会获胜。他们可能会拒绝三个小错误,但他们不会拒绝一个包含三个小部分的大错误。

我相信,如果你遵循这些简单的建议,你将成为一个更成功的错误报告者。至少在Zerocracy上是如此。

Translated by ChatGPT gpt-3.5-turbo/42 on 2023-12-27 at 04:42

sixnines availability badge   GitHub stars