在說明文件中,我們提供了建議規則清單。
這組高品質規則可為使用者帶來良好體驗。我們能夠區分支援的規則和網際網路上數百項規則。
提名名單
如果規則集符合以下要求,規則維護人員可以提交 GitHub 問題,在建議規則中提名。
經過 Bazel 核心小組審查後,我們將在 Bazel 網站上建議您這麼做。
規則維護人員相關規定
- 規則集提供了重要功能,對於大量 Bazel 使用者來說相當實用,例如支援廣受歡迎的語言。
- 規則集維護良好。至少要有 2 位有效維護人員。
- 規則集不僅有條理分明,還附有範例和使用方法。
- 規則集遵循最佳做法且效能良好 (請參閱效能指南)。
- 規則組具備足夠的測試涵蓋範圍。
- 在 BuildKite 上使用最新版本的 Bazel 測試規則集。測試一律通過 (做為預先提交檢查使用)。
- 系統也會針對即將不相容的變更進行變更測試規則集。拆分應該在兩週內修正。遷移問題應迅速回報給 Bazel 團隊,
Bazel 開發人員需求
- 建議規則經常在頭部使用 Bazel 測試 (每天至少一次)。
- Bazel 沒有變更,可能會違反建議的規則 (使用預設的標記組合)。如果發生這種情況,請進行修正或復原。
降級
如果您擔心特定規則集不再符合需求,請提交 GitHub 問題。
我們會通知規則維護人員,您必須在 2 週內回覆。根據結果,Bazel 核心團隊可能會決定將規則集降級。