推荐规则

报告问题 查看源代码

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

这是一套高质量规则,可为我们的用户提供良好的体验。我们对支持的规则和互联网上的数百条规则进行了区分。

提名

如果规则集符合以下要求,规则维护人员可以通过提交 GitHub 问题,提名该规则集加入推荐规则

经过 Bazel 核心团队的审核后,Bazel 网站将建议使用 Bazel。

对规则维护者的要求

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

针对 Bazel 开发者的要求

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

降位

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

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