Bazel は、特定の分野での共同作業に焦点を当て、Bazel のオーナー、メンテナンス担当者、コントリビューター間のコミュニケーションと調整をサポートするために、Special Interest Group(SIG)をホストします。このポリシーは 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 の目的とメリット(サブプロジェクトまたはアプリケーション領域)が明確であること
- グループ リーダーとして行動する意思のある 2 人以上のコントリビューター、他のコントリビューターの存在、グループに対する需要の証拠
- 各グループは、一般公開されているメーリング リストを 1 つ以上使用する必要があります。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 の行動規範に従う必要があります。グループのアーカイブは一般公開されます。承認なしで誰でも参加できるようにするか、グループ管理者の承認があればリクエストに応じて利用できます。
この憲章では管理者を指名する必要があります。グループには管理者に加えて、1 人以上のリーダー(同じ人物でも構いません)を含める必要があります。このリーダーは Bazel プロダクト チームによる調整の連絡先として機能します。
グループ作成者は、作成した憲章をグループのメーリング リストに投稿する必要があります。このようなドキュメントやポリシーは、Bazel GitHub 組織のコミュニティ リポジトリにアーカイブされています。グループは、その手法や規則を進化させるにつれて、コミュニティ リポジトリの関連する部分内で憲章を更新する必要があります。
コラボレーションとインクルージョン
必須ではありませんが、グループ通話やチャット チャネルでスケジュールされているコラボレーションを利用して会議を実施する必要があります。このような会議はメーリング リストで宣伝し、その後にメモをメーリング リストに投稿します。定期的なミーティングは、SIG の説明責任と進捗の促進に役立ちます。
Bazel プロダクト チームのメンバーは、グループを積極的にモニタリングし、必要に応じてディスカッションとアクションを促すことができます。
SIG を立ち上げる
必須のアクティビティ:
- Bazel の一般的なディスカッション グループ(bazel-discuss、bazel-dev)に通知します。
オプションのアクティビティ:
- Bazel ブログのブログ投稿を作成する
SIG の健全性と終了
Bazel のオーナーは、SIG の健全性を確保するために最善を尽くします。Bazel オーナーは、SIG リードに SIG の作業について報告し、より広範な Bazel コミュニティにグループのアクティビティを通知するよう要求することがあります。
有益な目的や関心を持ったコミュニティが SIG になくなった場合は、アーカイブされ、運営が停止される可能性があります。Bazel プロダクト チームは、プロジェクト全体の健全性を維持するために、このような無効な SIG をアーカイブする権限を有しますが、これはあまり望ましくありません。SIG は、有効期間が終了したことを認識した場合も、破棄を選択できます。
注
このコンテンツは、Tensorflow の SIG ハンドブックから引用され、変更されています。