本頁說明 Bazel 的管理模型和貢獻政策。
資料管理模型
Bazel 專案由 Google 主導,並有眾多 Google 以外的貢獻者社群。部分 Bazel 元件 (例如 bazelbuild 機構底下的特定規則存放區) 是由社群成員主導、維護和管理。Google Bazel 團隊會審查將社群擁有的存放區 (例如規則) 新增至 bazelbuild GitHub 機構的建議。
協作者角色
以下列舉 Bazel 專案中的角色,以及其角色:
- 擁有者:Google Bazel 團隊。擁有者必須負責:
- Bazel 專案的策略、維護和領導能力。
- 建構及維護 Bazel 的核心功能。
- 指派維護人員及核准新的存放區。
- 維護人員:Google Bazel 團隊和指定的 GitHub 使用者。
維護人員應對:
- 建構及維護其存放區的主要功能。
- 審查及核准對 Bazel 程式碼基礎領域的貢獻。
- 及時透明公開的問題管理、公關審查和說明文件,協助使用者和貢獻者提供協助。
- 與 Bazel 擁有者一起發布、測試和協同合作。
- 協作者:為 Bazel 專案提供程式碼或說明文件的所有使用者。
- 建立完善的 PR,以貢獻 Bazel 的程式碼集和說明文件。
- 使用標準管道 (例如 GitHub 問題) 來提議變更及回報問題。
成為維護者
Bazel 擁有者可能會指派維護者負責定義明確定義的程式碼規則,例如規則集。貢獻者過去曾貢獻己力,且必須做出重大貢獻,因此可能被視為合格的維護者。
捐款政策
Bazel 專案接受外部貢獻者的貢獻。以下是 Google 代管和社群代管程式碼的捐款政策。
- 授權。所有維護人員和貢獻者均必須簽署《Google 貢獻者授權協議》。
- 貢獻。業主和維護人員會盡力接受包含貢獻的貢獻, 所有貢獻都必須符合下列條件:
- 良好且經過充分測試
- 由相關程式碼領域的人員進行討論和核准。 討論和核准是發生於 GitHub 問題和 GitHub 公關。如要進行較大的貢獻,您必須完成設計審查。
- 如果已加入 Bazel 的持續整合系統 (如果沒有這項系統的話),
- 支援 Bazel 產品,並與 Bazel 產品方向一致
- 程式碼審查。所有
bazelbuild
存放區中的所有變更都需要審查:- 所有 PR 都必須經過業主或管理者核准。
- 只有擁有者和維護人員可以合併 PR。
- 相容性: 在極少數情況下,擁有者可能需要在內部 Google 系統進行重大修改時,才能拒絕或要求 PR 修改。
- 說明文件。如有需要,功能貢獻應包括說明文件更新。
如要進一步瞭解如何提供 Bazel 支援,請參閱我們的貢獻指南。