推荐规则

报告问题 查看源代码 每夜版 · 8.4 · 8.3 · 8.2 · 8.1 · 8.0 · 7.6

在文档中，我们提供了一份推荐规则列表。

这是一组优质规则，可为我们的用户提供良好的体验。我们区分了受支持的规则和您在网上找到的数百条规则。

提名

如果某个规则集符合以下要求，规则维护者可以提交 GitHub 问题，提名该规则集成为推荐规则的一部分。

在经过 Bazel 核心团队审核后，该工具将在 Bazel 网站上获得推荐。

规则维护者的要求

  • 规则集提供对大量 Bazel 用户有用的重要功能（例如，支持一种广泛使用的语言）。
  • 规则集维护良好。必须至少有两位有效维护者。
  • 该规则集有完善的文档记录，并附有示例，易于使用。
  • 该规则集遵循最佳实践，并且性能良好（请参阅性能指南）。
  • 规则集具有足够的测试覆盖率。
  • 该规则集已在 BuildKite 上使用最新版本的 Bazel 进行过测试。测试应始终通过（当用作预提交检查时）。
  • 还会使用即将发布的不兼容变更来测试规则集。损坏应在两周内修复。应尽快向 Bazel 团队报告迁移问题。

针对 Bazel 开发者的要求

  • 建议的规则会经常使用 Bazel 在 Head 分支上进行测试（至少每天一次）。
  • Bazel 中的任何更改都不会破坏推荐规则（使用默认标志集）。如果发生这种情况，应修复或回滚相应更改。

降级

如果您担心某个特定规则集不再符合要求，应提交 GitHub 问题。

我们会联系规则维护者，他们需要在 2 周内做出回应。根据结果，Bazel 核心团队可能会决定降级规则集。