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