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 群組，請先收集下方有待核准的證據。可以考慮的管道如下：

  • 定義完善的問題或群組可解決的問題
  • 諮詢獲益良多的社群成員，同時評估這些好處和意願
  • 以現有專案來說，問題來源和貢獻者所關注的議題
  • 群組可能達成的目標
  • 執行群組的資源需求

即使 SIG 的需求似乎顯然與眾不同，研究和諮詢仍對該群組的成功仍很重要。

建立新群組

新群組應按照下列程序來編排。請特別注意，此範例必須：

  • Bazel 的明確用途和優點 (子專案或應用程式區域周圍)
  • 兩個以上的貢獻者願意擔任團體負責人、有其他貢獻者，以及確認小組的需求
  • 每個群組必須至少使用一份可公開存取的郵寄清單。SIG 可重複使用其中一個公開清單 (例如 bazel-discuss)、要求 @bazel.build 清單，或自行建立清單
  • SIG 最初需要的資源 (通常是郵寄清單和一般視訊通話)。
  • SIG 可從 bazelbuild/community 目錄中的目錄或 bazelbuild GitHub 機構的自有存放區提供文件和檔案。如果 SIG 選擇將工作安排到 bazelbuild GitHub 機構以外，則 SIG 可能會連結至外部資源
  • Bazel 擁有者核准或拒絕 SIG 應用程式，並視需要諮詢相關人員

進入正式流程之前，建議您先向 Bazel 產品小組諮詢 product@bazel.build。大部分的 SIG 需要經過核准和疊代作業才能獲得核准。

針對新群組的正式要求，您只要向 bazelbuild/community 提交 PR 的要求，然後將要求提交為 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 發現其使用壽命已結束，即會選擇解除對其的失能。

注意事項

這些內容已從 Tensorflow 的 SIG 教戰手冊中經過修改。