Bazel 代管特殊興趣群組 (SIG),將重點放在特定領域的協作,並支援 Bazel 擁有者、維護人員與貢獻者之間的通訊和協調。這項政策適用於 bazelbuild
。
SIG 會公開工作。SIG 的理想範圍涵蓋一個明確定義的領域,其中大部分的參與都來自社群。SIG 可能會著重在 bazelbuild
中由社群維護的存放區 (例如語言規則),或著重在 Bazel 存放區中的程式碼區域 (例如遠端執行)。
雖然不是所有 SIG 都有相同等級的能源、範圍或管理模型,但應有充分的證據證明,當成立利益團體時,有社群成員願意參與並貢獻一己之力。加入前,請先檢查群組的工作,然後與 SIG 負責人聯絡。成員資格政策因 SIG 而異。
請參閱 Bazel SIG 的完整清單。
非目標:SIG 不適用的部分
SIG 旨在促進共用工作。SIG 則代表:
- 非支援論壇:郵寄清單和 SIG 並不相同
- 不需立即要求:在專案生命週期的初期,您可能不知道自己是否共用過工作或協作者
- 非自由勞力:需要能源才能壯大及合作協調工作
Bazel 擁有者採用保守的方式建立 SIG,因此如要在 GitHub 上輕鬆啟動專案,在不需要 SIG 的情況下也能進行協作。
SIG 生命週期
本節說明如何建立 SIG。
研究與諮詢
如要建議新的 SIG 群組,請先收集證據以供核准,如下所述。以下為幾個可能的可行做法:
- 小組可以解決的一個明確問題或一組問題
- 諮詢會獲益的社群成員,評估他們的利益 以及是否願意承諾
- 如為現有專案,則由貢獻者所關注該主題的問題和 PR 提供的證據
- 群組要達成的可能目標
- 執行群組的資源需求
即使對 SIG 的需求看似無害,但研究和諮詢仍對於團隊的成功與否仍相當重要。
建立新群組
新群組應依照下列程序包銷。其中必須特別展示:
- Bazel 明確的目的和優點 (對於子專案或應用程式區域)
- 兩個以上願意擔任團體待開發客戶的貢獻者、其他貢獻者的存在,以及群組的需求證據
- 每個群組必須使用至少一個可公開存取的郵寄清單。SIG 可能會重複使用其中一個公開清單 (例如 bazel-discuss)、要求 @bazel.build 清單或建立自己的清單
- SIG 最初需要的資源 (通常為郵寄清單和一般視訊通話)。
- SIG 可以從
bazelbuild/community
的目錄或bazelbuild
GitHub 機構的專屬存放區提供文件和檔案。如果 SIG 選擇在bazelbuild
GitHub 機構之外組織工作,則可連結至外部資源 - Bazel 擁有者會核准或拒絕 SIG 應用程式,並視需要諮詢其他相關人員
在進入程序的正式部分之前,建議您先透過 product@bazel.build 與 Bazel 產品團隊諮詢。大部分的 SIG 都需先進行對話和疊代作業才能獲得核准。
新群組的正式要求是透過將 PR 形式提交給 bazelbuild/community
,並在 PR 的註解中加入要求 (按照下方範本撰寫)。核准後,系統會合併群組的 PR 並建立必要資源。
新 SIG 的範本要求
如要要求新的 SIG,請使用社群存放區中的範本:SIG-request-template.md。
租用
如要建立群組,您需要有指導員,並遵循 Bazel 行為準則。群組的封存資料將公開。即使未經群組管理員核准,成員資格也可能開放給所有人存取;如有需要,也可應要求成員提供。
章程不得指定一名管理員。做為管理員,該群組至少須有一人 (這些人可能是同一人),擔任 Bazel 產品團隊所需的協調聯絡窗口。
群組創作者必須將他們的特許資訊張貼到群組郵寄清單。Bazel GitHub 機構中的社群存放區會封存這類文件和政策。隨著群組不斷演進其做法和慣例,他們應在社群存放區的相關部分更新其章程。
促進合作及包容
雖然非強制規定,但群組應選擇利用排定的電話通話或即時通訊管道進行協作。任何這類會議都應在郵寄清單內宣傳,之後張貼在郵寄清單中。定期會議有助於推動 SIG 的責任和進展
Bazel 產品團隊成員可以主動監控,並鼓勵相關人員視情況討論及採取行動。
啟動 SIG
必要活動:
- 通知 Bazel 一般討論群組 (bazel-discuss、bazel-dev)。
可考慮進行的活動:
- 為 Bazel 網誌建立網誌文章
SIG 健康與終止
Bazel 擁有者會盡力確保 SIG 的健康狀態。Bazel 擁有者有時會要求 SIG 負責回報 SIG 的工作,以通知群組活動的更多 Bazel 社群。
如果 SIG 不再有實用目的或感興趣的社群,則可能會封存並停止作業。Bazel 產品團隊保留封存這類閒置 SIG 的權利,以維持專案的整體健康狀態,但這並不是理想的結果。如果 SIG 發現自身的使用壽命已結束時,也可以選擇取消頻帶。
注意事項
這些內容均取自 Tensorflow 的 SIG 教戰手冊,並經過修改。