建議的規則

回報問題 查看來源 Nightly · 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 核心團隊可能會決定降級規則集。