Bazel 代管特殊興趣群組 (SIG),將心力集中在特定區域,並支援 Bazel 擁有者、維護者和貢獻者之間的通訊與協調。這項政策適用於 bazelbuild
。
SIG 會公開發布其工作。SIG 的理想範圍是定義明確的網域,大多數的參與都來自社群。SIG 可能會著重於 bazelbuild
中的社群維護存放區 (例如語言規則),或著重於 Bazel 存放區中的程式碼領域 (例如 Remote Execution)。
雖然並非所有 SIG 具有相同的能源、廣泛範圍或政府模式,但有足夠的證據顯示社群成員應該願意參與並貢獻一己之力。的 Google Ads 新帳戶重新申請驗證。加入之前,請先詳閱群組的工作內容,並與 SIG 負責人聯絡。成員政策因 SIG 而異。
請參閱 Bazel SIG 的完整清單。
非目標:SIG 是什麼
SIG 旨在協助促進協同合作。SIG 是:
- 不是支援論壇:郵寄清單和 SIG 不同
- 目前不需要:提前在專案生命週期中,如果您不確定是否有工作或協作者,則可能不知道
- 無自由人力:需要能源才能發展及協調工作方式
Bazel 擁有者可以採取保守的做法,建立 SIG;如此就像在 GitHub 上啟動專案一樣,有許多合作方式可以在沒有 SIG 的情況下進行。
SIG 生命週期
本節說明如何建立 SIG。
研究和諮詢
如要建議新的 SIG 群組,請先收集如下方所示的核准證明。可以考慮的途徑如下:
- 明確定義的問題或群組能解決問題
- 諮詢有助於找出福利的成員,並評估相關福利與承諾
- 針對現有專案,提供問題及貢獻者的公關觀點
- 群組達成的潛在目標
- 執行群組的資源需求
即使 SIG 的需求相當自主,研究和諮詢在團隊的表現上仍相當重要。
建立新群組
新的群組應按照下列圖表程序執行。請特別注意,其中必須明確說明下列事項:
- 對 Bazel 有明確目的和優勢 (位於子專案或應用程式區域周圍)
- 兩位以上的貢獻者願意擔任群組領導人、其他著作人,以及有需求的需求證明
- 每個群組都必須至少使用一份可公開存取的郵寄清單。SIG 可能會重複使用其中一個公開清單 (例如 bazel-talk)、要求 @bazel.build 的清單,或自行建立清單
- SIG 最初要求的資源 (通常是郵寄清單和一般視訊通話)。
- SIG 可以透過
bazelbuild/community
中的目錄或bazelbuild
GitHub 中的存放區提供文件和檔案{。 101}機構。SIG 選擇透過bazelbuild
GitHub 機構以外的方式管理工作時,可能會連結至外部資源 - Bazel 擁有者會核准或拒絕 SIG 應用程式,並視需要諮詢其他相關人員
進入正式流程前,請先洽詢 Bazel 產品團隊:product@bazel.build。大多數的 SIG 都需要核准和疊代作業才能通過核准。
新群組的正式要求是提交 PR 以提交
bazelbuild/community
,並在下列範本中加入公關註解中的要求。核准後,系統會合併群組的 PR,並建立必要的資源。
要求新 SIG 的範本要求
如要索取新的 SIG,請使用社群存放區中的範本:SIG-request-template.md。
租用
如要建立群組,您必須建立圖表,且必須遵守 Bazel 的行為程式碼。 群組封存資料會公開顯示。成員資格可以是所有未獲核准的使用者開放,或是在要求管理員核准之前有權要求。
該組織須指定管理員。管理員和群組必須包含至少一位使用者做為待開發客戶 (可以是相同的人),按照 Bazel 產品團隊的需求做為協調聯絡人。
群組建立者必須在群組郵寄清單張貼圖表。Bazel GitHub 機構中的社群存放區會將這類文件和政策封存。隨著各組不斷演進做法和慣例,團隊會更新社區存放區的相關部分。
協同合作與包容
雖然群組沒有強制規定,但群組應選擇透過排定的會議或即時通訊管道使用協作功能來開會。這類會議一律應列在郵寄清單中,並在事後發布在郵寄清單中。定期會議可協助推動 SIG 的可靠度與進度。
Bazel 產品團隊成員可主動監控並鼓勵群組討論和採取行動。
啟用 SIG
必要活動:
- 通知 Bazel 一般討論群組 (bazel-talk、bazel-dev)。
選用活動:
- 為 Bazel 網誌建立網誌文章
SIG 的健康狀態與終止
Bazel 擁有者會盡力確保 SIG 的健康狀態。Bazel 擁有者有時會要求 SIG 報告 SIG 的工作報告,通知廣泛的 Bazel 社群相關活動。
如果 SIG 不再需要實用的用途或社群,可能會遭到封存和停止運作。Bazel 產品團隊保留封存已停用的 SIG 的權利,以維持專案的整體健康狀態,但結果較不理想。此外,如果 SIG 發現裝置已屆滿其使用壽命,也可以選擇不採用。
注意事項
這項內容取自 Tensorflow 的 SIG 教戰手冊,並進行修改。