为 Discourse 在 Meta 上创建 Bug 报告

:bookmark: 这是关于使用正确的渠道报告您在 Discourse 中发现的错误的指南。

:person_raising_hand: 所需用户级别:任何人都可以报告错误

当您遇到会破坏或阻止 Discourse 正常使用的问​​题时,报告此错误至关重要,以便可以解决和修复它。报告错误有助于改善每个人的平台体验——本指南将指导您完成在 Meta 上有效报告错误的流程,这是为 Discourse 做出贡献的绝佳方式。

摘要

在本指南中,您将了解到:

  • 如何确保错误尚未解决
  • 如何在官方 Discourse 测试环境中验证问题
  • 如何创建详细的错误报告

确保错误尚未解决

在报告错误之前,请在 Meta 的错误类别中搜索类似的问题,以确保它尚未被报告。这有助于避免重复报告,并提供有关错误是否已被承认或修复的见解。

验证问题

为确认您的问题是可重现的错误而不是特定于您的设置:

  1. try.discourse.org 上测试:使用 try.discourse.org 上的默认沙盒来查看您是否可以复制该问题。
  2. 使用 latest 频道:如果您在自己的 Discourse 实例上进行测试,请确保使用 latest 分支

高级步骤(可选)

  • 提交 Pull Request:如果您有能力,请提交一个包含失败测试的 pull request,以演示该错误。
  • 自己修复错误:如果您更愿意自己解决问题,请遵循 Contributing to Discourse development

创建详细的错误报告

最后,如果问题仍然存在并且您已在测试环境中确认了它:

  1. 在错误类别中打开一个主题:前往 Meta 上的错误类别并创建一个新主题。
  2. 包含可重现的步骤:详细说明您关于错误的所知的一切,包括重现它的步骤。请参阅关于如何撰写良好错误报告的指南,以获取有关包含哪些信息的提示。

一旦错误被修复,您通常可以期待更新发布在报告主题中。


附加资源

18 个赞