建議的規則

說明文件中提供建議規則清單。

這是一組高品質規則，可為使用者提供良好體驗。我們會區分支援的規則，以及您在網路上找到的數百條規則。

提名

如果規則集符合下列規定，規則維護者可以提交 GitHub 問題，將該規則集提名為建議規則的一部分。

經 Bazel 核心團隊審查後，會在 Bazel 網站上推薦。

規則維護者的相關規定

• 規則集提供重要功能，對大量 Bazel 使用者而言相當實用 (例如支援廣受歡迎的語言)。
• 規則集維護良好。至少要有兩位有效維護者。
• 規則集有詳細說明文件和範例，使用起來也相當簡單。
• 規則集會遵循最佳做法，且效能良好 (請參閱效能指南)。
• 規則集有足夠的測試涵蓋率。
• 我們使用最新版本的 Bazel 在 BuildKite 上測試規則集。測試應一律通過 (用於提交前檢查時)。
• 我們也針對即將推出的不相容變更測試規則集。中斷情形應在兩週內修正。請盡快向 Bazel 團隊回報遷移問題。

Bazel 開發人員的規定

• 建議的規則會經常使用 Bazel 進行測試 (至少每天測試一次)。
• 在 Bazel 中，任何變更都不會違反建議的規則 (使用預設的標記集)。如果發生這種情況，請修正或還原變更。

降級

如果您認為特定規則集不再符合規定，請提交 GitHub 問題。

我們會與規則維護者聯絡，要求他們在 2 週內回覆。根據結果，Bazel 核心團隊可能會決定降級規則集。