translation: human page_type: lcat
回報問題 查看原始碼 Nightly · 8.0 7.4 . 7.3 · 7.2 · 7.1 · 7.0 · 6.5
本頁面說明 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 的 Contributor License Agreement。
- 貢獻。擁有者和維護者應盡力接受有價值的貢獻。所有內容都必須符合以下條件:
- 編寫和測試良好
- 已與相關程式碼區塊的維護者討論並獲得核准。討論和核准作業會在 GitHub 問題和 GitHub PR 中進行。較大的貢獻內容需要進行設計審查。
- 已新增至 Bazel 的持續整合系統 (如果尚未新增)。
- 可支援且符合 Bazel 產品方向
- 程式碼審查。所有
bazelbuild
存放區中的所有變更都需要審查:- 所有提交的修訂要求都必須經過擁有者或維護者的核准。
- 只有擁有者和維護者可以合併提交要求。
- 相容性。如果變更需要大幅修改 Google 內部系統,則擁有者可能需要拒絕或要求修改 PR。
- 說明文件。在相關情況下,功能貢獻應包含說明文件更新。
如要進一步瞭解如何為 Bazel 貢獻內容,請參閱貢獻指南。