在该文档中,我们提供了一个推荐规则列表。
这是一套高质量规则,可为我们的用户提供良好的体验。我们对支持的规则和互联网上的数百条规则进行了区分。
提名
如果规则集符合以下要求,规则维护人员可以通过提交 GitHub 问题,提名该规则集加入推荐规则。
经过 Bazel 核心团队的审核后,Bazel 网站将建议使用 Bazel。
对规则维护者的要求
- 该规则集提供对大量 Bazel 用户有用的重要功能(例如,支持一种广受欢迎的语言)。
- 规则集得到很好的维护。必须至少有两个活跃的维护者。
- 该规则集文档完备、包含示例且易于使用。
- 该规则集遵循最佳实践,并且性能出色(请参阅性能指南)。
- 规则集具有足够的测试覆盖范围。
- 系统会在使用最新版本的 Bazel 的 BuildKite 上测试规则集。测试应始终通过(用作提交前检查时)。
- 此外,系统还会使用即将推出的不兼容更改对规则集进行测试。损坏情况应在两周内修复。迁移问题应快速报告给 Bazel 团队
针对 Bazel 开发者的要求
- 推荐的规则经常使用 Bazel 头部测试(至少每天一次)。
- 对 Bazel 所做的任何更改都不会破坏推荐的规则(使用一组默认标志)。如果出现这种情况,应修正或回滚更改。
降位
如果您担心特定规则集不再满足要求,则应提交 GitHub 问题。
我们会与规则维护者联系,并需要在 2 周内做出回应。根据评估结果,Bazel 核心团队可能会决定将规则集降位。