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 機構外部，SIG 可能會連結至外部資源
  • Bazel 擁有者核准或拒絕 SIG 應用程式，並視需要諮詢其他相關人員

進入程序的正式部分之前，您應透過 product@bazel.build 洽詢 Bazel 產品團隊。大部分的 SIG 都需要在核准前進行對話和疊代。

新群組的正式要求是透過將邀約者提交為 bazelbuild/community 的 PR 提交，並按照下方範本在 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 認為其實用壽命已經結束，SIG 也可能會選擇停用。

注意事項

這項內容來自 Tensorflow 的 SIG 教戰手冊，並經過修改。