建議的規則

在說明文件中,我們提供了建議規則清單。

這是一組優質規則,可為使用者提供良好的體驗。我們會區分支援的規則與網際網路上的數百項規則。

入圍

如果規則集符合下列規定,規則維護人員可提交 GitHub 問題,將規則集中指定為建議規則的一部分。

Bazel Core 團隊審查後,會在 Bazel 網站上推薦使用。

規則維護者的要求

  • 規則集為大量 Bazel 使用者提供了重要功能,例如支援廣受歡迎的語言。
  • 規則集維護情況良好。至少要有兩名積極維護人員。
  • 規則集詳列資訊、範例和易用。
  • 規則集符合最佳做法,且成效良好 (請參閱效能指南)。
  • 規則集的測試涵蓋範圍充足。
  • 您可以在 BuildKite 上使用最新版的 Bazel 測試規則集。測試應一律通過 (做為預先提交檢查使用)。
  • 此外,系統也會測試規則集,測試即將發布的不相容變更。中斷應在兩週內修正。Bazel 團隊應該很快就會回報遷移問題。

Bazel 開發人員的需求

  • 系統通常會先用 Bazel 測試建議規則 (每天至少測試一次)。
  • Bazel 中的任何變更都可能會破壞建議規則 (使用預設的標記組合)。如果發生這種情形,則應修正或復原變更。

降低排名

如果擔心特定規則集不再符合需求,則應提交 GitHub 問題

我們會與規則維護人員聯絡,並在 2 週內回覆。根據結果,Bazel Core 團隊可能會決定將規則集降級。