推荐规则

报告问题 查看源代码 每夜 build · 8.0 · 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 核心团队可能会决定降级规则集。