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