建議規則

回報問題 查看原始碼

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

這組高品質規則可為使用者帶來良好體驗。我們能夠區分支援的規則和網際網路上數百項規則。

提名名單

如果規則集符合以下要求,規則維護人員可以提交 GitHub 問題,在建議規則中提名。

經過 Bazel 核心小組審查後,我們將在 Bazel 網站上建議您這麼做。

規則維護人員相關規定

  • 規則集提供了重要功能,對於大量 Bazel 使用者來說相當實用,例如支援廣受歡迎的語言。
  • 規則集維護良好。至少要有 2 位有效維護人員。
  • 規則集不僅有條理分明,還附有範例和使用方法。
  • 規則集遵循最佳做法且效能良好 (請參閱效能指南)。
  • 規則組具備足夠的測試涵蓋範圍。
  • BuildKite 上使用最新版本的 Bazel 測試規則集。測試一律通過 (做為預先提交檢查使用)。
  • 系統也會針對即將不相容的變更進行變更測試規則集。拆分應該在兩週內修正。遷移問題應迅速回報給 Bazel 團隊,

Bazel 開發人員需求

  • 建議規則經常在頭部使用 Bazel 測試 (每天至少一次)。
  • Bazel 沒有變更,可能會違反建議的規則 (使用預設的標記組合)。如果發生這種情況,請進行修正或復原。

降級

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

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