推荐规则

<ph type="x-smartling-placeholder"></ph> 报告问题 查看来源 敬上 每晚 · 7.3。 · 7.2 条 · 7.1。 · 7.0。 · 6.5 条

在此文档中，我们列出了 推荐规则。

这是一套高质量规则， 用户。我们区分了所支持的规则和数以百计的规则 您在互联网上可以找到的规则。

提名

如果规则集满足以下要求，规则维护人员可以提名该规则集 提交推荐规则 GitHub 问题。

在经过 Bazel 核心团队的审核之后， 。

对规则维护者的要求

  • 规则集提供了一项重要功能，对大量 Bazel 来说非常有用 用户（例如，对某种广泛流行的语言的支持）。
  • 规则集得到很好的维护。必须至少有两个活跃的维护者。
  • 该规则集文档完备、包含示例且易于使用。
  • 规则集遵循最佳做法，性能出色（请参阅 性能指南）。
  • 规则集具有足够的测试覆盖范围。
  • 规则集会在 BuildKite 最新版本的 Bazel测试应始终通过（用作 提交前检查）。
  • 此外，系统还会使用即将推出的不兼容更改对规则集进行测试。损坏 应该在两周内解决。迁移问题应报告给 Bazel 团队

针对 Bazel 开发者的要求

  • 推荐的规则经常使用 Bazel 头部测试（至少 天）。
  • 在 Bazel 中，任何更改都不会违反推荐的规则（使用 标志）。如果出现这种情况，应修正或回滚更改。

降位

如果担心特定规则集不再符合 GitHub 问题 已提交。

我们会与规则维护者联系，并需要在 2 周内做出回应。基于 则 Bazel 核心团队可能会决定将规则集降位。