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