Bazel 特殊興趣群組

回報問題 查看來源

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 網誌建立網誌文章

SIG 健康與終止

Bazel 擁有者會盡力確保 SIG 的健康狀態。Bazel 擁有者有時會要求 SIG 負責回報 SIG 的工作，以通知群組活動的更多 Bazel 社群。

如果 SIG 不再有實用目的或感興趣的社群，則可能會封存並停止作業。Bazel 產品團隊保留封存這類閒置 SIG 的權利，以維持專案的整體健康狀態，但這並不是理想的結果。如果 SIG 發現自身的使用壽命已結束時，也可以選擇取消頻帶。

注意事項

這些內容均取自 Tensorflow 的 SIG 教戰手冊，並經過修改。