本指南介绍如何通过正确的渠道报告在 Discourse 中发现的 bug。
所需用户等级:任何人都可以报告 bug
当您遇到破坏或阻止 Discourse 正常使用的错误时,报告此 bug 至关重要,以便对其进行修复。报告 bug 有助于为所有人改善平台——本文档将指导您在 Meta 上有效地报告 bug,这是 为 Discourse 做出贡献 的绝佳方式。
摘要
在本指南中,您将学习:
- 如何确保该 bug 尚未被修复
- 如何在官方 Discourse 测试环境中验证该问题
- 如何创建详细的 bug 报告
确保 bug 尚未被修复
在报告 bug 之前,请在 Meta 的 bug 类别 中搜索类似问题,以确保它尚未被报告。这有助于避免重复报告,并提供有关该 bug 是否已被确认或修复的见解。
验证问题
为了确认您的问题是一个可重现的 bug,而不是特定于您的设置:
- 在 try.discourse.org 上测试:使用 try.discourse.org 上的默认沙箱,看看是否可以重现该问题。
- 使用
latest渠道:如果您在自己的 Discourse 实例上测试,请确保使用latest分支
高级步骤(可选)
- 提交拉取请求:如果您有能力,提交一个包含失败测试的拉取请求,以演示该 bug。
- 自行修复 bug:如果您更喜欢自己解决问题,请遵循 Contributing to Discourse development
创建详细的 bug 报告
最后,如果问题仍然存在,并且您已在测试环境中确认:
- 在 bug 类别中打开主题:前往 Meta 上的 bug 类别 并创建新主题。
- 包含可重现的步骤:详细说明您关于该 bug 的所有已知信息,包括重现它的步骤。参考 如何编写好的 bug 报告 指南,了解应包含哪些信息的提示。
一旦 bug 被修复,您通常可以期望在报告主题中发布更新。