在Meta上为Discourse创建错误报告

:bookmark: 本指南介绍如何通过正确的渠道报告在 Discourse 中发现的 bug。

:person_raising_hand: 所需用户等级:任何人都可以报告 bug

当您遇到破坏或阻止 Discourse 正常使用的错误时,报告此 bug 至关重要,以便对其进行修复。报告 bug 有助于为所有人改善平台——本文档将指导您在 Meta 上有效地报告 bug,这是 为 Discourse 做出贡献 的绝佳方式。

摘要

在本指南中,您将学习:

  • 如何确保该 bug 尚未被修复
  • 如何在官方 Discourse 测试环境中验证该问题
  • 如何创建详细的 bug 报告

确保 bug 尚未被修复

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

验证问题

为了确认您的问题是一个可重现的 bug,而不是特定于您的设置:

  1. try.discourse.org 上测试:使用 try.discourse.org 上的默认沙箱,看看是否可以重现该问题。
  2. 使用 latest 渠道:如果您在自己的 Discourse 实例上测试,请确保使用 latest 分支

高级步骤(可选)

  • 提交拉取请求:如果您有能力,提交一个包含失败测试的拉取请求,以演示该 bug。
  • 自行修复 bug:如果您更喜欢自己解决问题,请遵循 Contributing to Discourse development

创建详细的 bug 报告

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

  1. 在 bug 类别中打开主题:前往 Meta 上的 bug 类别 并创建新主题。
  2. 包含可重现的步骤:详细说明您关于该 bug 的所有已知信息,包括重现它的步骤。参考 如何编写好的 bug 报告 指南,了解应包含哪些信息的提示。

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


附加资源

18 个赞