推荐规则

报告问题 查看源代码 每夜 build · 7.4 . 7.3 · 7.2 · 7.1敬上 · 7.0敬上 · 6.5

在文档中,我们提供了推荐规则列表。

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

提名

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

Bazel 核心团队审核后,我们会在 Bazel 网站上推荐该插件。

对规则维护者的要求

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

针对 Bazel 开发者的要求

  • 推荐的规则经常使用 Bazel 头部测试(至少 天)。
  • Bazel 中的任何更改都不会破坏推荐规则(使用默认的一组标志)。如果发生这种情况,应修正或回滚更改。

降位

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

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