Bazel 特殊興趣群組

回報問題 查看原始碼 Nightly · 8.0 . 7.4 . 7.3 · 7.2 · 7.1 · 7.0 · 6.5

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 申請，並視需要諮詢其他利害關係人

在進入正式程序之前，請先洽詢 Bazel 產品團隊 (product@bazel.build)。大多數 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 手冊中採用。