建議的規則

回報問題 查看來源

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

這是一套高品質規則,可為使用者提供良好的體驗。我們會區分支援的規則和您可以在網際網路中找到的數百項規則。

提名

如果規則集符合下列要求,規則維護人員可以提交 GitHub 問題,提名規則維護人員將其提名為建議規則的一部分。

Bazel 核心團隊會經過 Bazel 核心團隊的審查,並在 Bazel 網站上推薦這個項目。

規則維護人員的需求條件

  • 規則集提供一項重要功能,適用於大量 Bazel 使用者 (例如支援廣受喜愛的語言)。
  • 規則集保持完善,至少必須有兩個有效的維護人員。
  • 規則集附有相關範例,而且易於使用。
  • 規則集遵循最佳做法且成效良好 (請參閱效能指南)。
  • 規則集的測試涵蓋範圍充足。
  • 規則集會在 BuildKite 上使用最新版本的 Bazel 進行測試。測試應一律通過 (當做預先提交檢查使用時)。
  • 此外,這個規則集也測試了即將生效的不相容變更。中斷作業應在兩週內修正。您應迅速向 Bazel 團隊回報遷移問題。

Bazel 開發人員必備條件

  • 我們經常會透過 Bazel 測試建議規則 (每天至少一次)。
  • 但是 Bazel 沒有任何變更,都可能違反建議的規則 (使用預設的標記組合)。在這種情況下,您應修正或復原變更。

降低排名

如果疑慮讓特定規則集不再符合要求,則應提交 GitHub 問題

我們會聯絡規則維護人員,必須在 2 週內回覆。Bazel 核心團隊會根據結果,決定將規則集降級。