推荐规则

报告问题 查看源代码

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

这是一套高质量的规则,可以为我们的用户提供良好的体验。我们会区分支持的规则和您可以在互联网上找到的数百条规则。

提名

如果规则集满足以下要求,则规则维护者可以通过提交 GitHub 问题来提名它作为推荐规则的一部分。

在经过 Bazel 核心团队的审核后,我们会将其推荐到 Bazel 网站上。

针对规则维护者的要求

  • 该规则集是一项重要功能,对许多 Bazel 用户非常有用(例如,支持一种广受欢迎的语言)。
  • 规则集维护良好。必须至少有两个活跃的维护者。
  • 该规则集内容详尽,包含相关示例,并且易于使用。
  • 该规则集遵循最佳做法,并且性能出色(请参阅性能指南)。
  • 该规则集有足够多的测试覆盖率。
  • 该规则集使用最新版本的 Bazel 在 BuildKite 上进行测试。测试应始终通过(用作提交前检查时)。
  • 此规则集还会测试即将发生的不兼容更改。应在两周内解决破坏问题。您应尽快向 Bazel 团队报告迁移问题。

对 Bazel 开发者的要求

  • 推荐规则经常使用 Bazel 进行测试(每天至少一次)。
  • Bazel 中的任何更改都可能违反建议的规则(使用默认的标记集)。如果出现这种情况,则应进行修正或回滚。

降位

如果您担心特定规则集不再符合要求,则应提交 GitHub 问题

我们会与规则维护者联系,并请对方在 2 周内回复。根据结果,Bazel 核心团队可能会决定将规则集降级。