推荐规则

<ph type="x-smartling-placeholder"></ph> 报告问题 查看来源 敬上 每晚 · 7.3。 · 7.2 条 · 7.1。 · 7.0。 · 6.5

在此文档中,我们列出了 推荐规则

这是一套高质量规则, 用户。我们区分了所支持的规则和数以百计的规则 您在互联网上可以找到的规则。

提名

如果规则集满足以下要求,规则维护人员可以提名该规则集 提交推荐规则 GitHub 问题

在经过 Bazel 核心团队的审核之后, 。

对规则维护者的要求

  • 规则集提供了一项重要功能,对大量 Bazel 来说非常有用 用户(例如,对某种广泛流行的语言的支持)。
  • 规则集得到很好的维护。必须至少有两个活跃的维护者。
  • 该规则集文档完备、包含示例且易于使用。
  • 规则集遵循最佳做法,性能出色(请参阅 性能指南)。
  • 规则集具有足够的测试覆盖范围。
  • 规则集会在 BuildKite 最新版本的 Bazel测试应始终通过(用作 提交前检查)。
  • 此外,系统还会使用即将推出的不兼容更改对规则集进行测试。损坏 应该在两周内解决。迁移问题应报告给 Bazel 团队

针对 Bazel 开发者的要求

  • 推荐的规则经常使用 Bazel 头部测试(至少 天)。
  • 在 Bazel 中,任何更改都不会违反推荐的规则(使用 标志)。如果出现这种情况,应修正或回滚更改。

降位

如果担心特定规则集不再符合 GitHub 问题 已提交。

我们会与规则维护者联系,并需要在 2 周内做出回应。基于 则 Bazel 核心团队可能会决定将规则集降位。