translation: human page_type: lcat
本頁說明 Bazel 的管理模式和貢獻政策。
資料管理模型
Bazel 專案由 Google 領導及管理,且有大量 Google 外部的貢獻者社群。部分 Bazel 元件 (例如 bazelbuild 機構下的特定規則存放區) 由社群成員主導、維護及管理。Google Bazel 團隊會審查建議,將社群擁有的存放區 (例如規則) 新增至 bazelbuild GitHub 機構。
投稿者角色
以下是 Bazel 專案中的角色,包括其職責:
- 擁有者:Google Bazel 團隊。擁有者須負責:
- Bazel 專案的策略、維護和領導。
- 建構及維護 Bazel 的核心功能。
- 指派維護人員及核准新存放區。
- 維護人員:Google Bazel 團隊和指定的 GitHub 使用者。維護者負責:
- 建構及維護存放區的主要功能。
- 審查並核准對 Bazel 程式碼庫領域的貢獻。
- 及時且公開地管理問題、審查 PR 和撰寫文件,為使用者和貢獻者提供支援。
- 發布、測試及與 Bazel 擁有者協作。
- 貢獻者:為 Bazel 專案貢獻程式碼或文件的所有使用者。
- 建立撰寫良好的 PR,為 Bazel 的程式碼集和說明文件做出貢獻。
- 使用 GitHub 問題等標準管道,提出變更建議及回報問題。
成為維護人員
Bazel 擁有者可以指派維護人員,負責領導明確定義的程式碼區域,例如規則集。如果貢獻者過去的貢獻記錄一向負責盡職,且計畫在未來做出重大貢獻,則可考慮讓他們成為合格的維護者。
貢獻政策
Bazel 專案接受外部貢獻者提供的內容。以下是 Google 管理和社群管理程式碼區域的貢獻政策。
- 授權。所有維護人員和貢獻者都必須簽署 Google 的貢獻者授權協議。
- 貢獻。擁有者和維護者應盡力接受有價值的貢獻。所有貢獻內容都必須:
- 撰寫良好且經過充分測試
- 經由相關程式碼領域的維護人員討論並核准。 討論和核准程序會在 GitHub 問題和 GitHub PR 中進行。 如果貢獻內容較多,則需要經過設計審查。
- 如果 Bazel 的持續整合系統中沒有這個項目,就會新增。
- 可支援且符合 Bazel 產品方向
- 程式碼審查。所有
bazelbuild
存放區的所有變更都必須經過審查:- 所有 PR 都必須由擁有者或維護者核准。
- 只有擁有者和維護者可以合併 PR。
- 相容性。如果變更需要大幅修改 Google 內部系統,擁有者可能需要拒絕或要求修改 PR。
- 說明文件。如適用,功能貢獻內容應包含文件更新。
如要進一步瞭解如何為 Bazel 貢獻心力,請參閱貢獻指南。