Bazel の Special Interest Group

Bazel は、特定の 分野でのコラボレーションに焦点を当て、Bazel のオーナー、 メンテナー、コントリビューター間のコミュニケーションと調整をサポートするために、特別関心グループ(SIG)をホストしています。このポリシー は bazelbuildに適用されます。

SIG は公開で作業を行います。SIG の理想的な範囲は、参加者の大半がコミュニティである、明確に定義されたドメインを対象としています。SIG は、bazelbuild のコミュニティ管理リポジトリ(言語ルールなど)に焦点を当てることも、Bazel リポジトリのコード領域(リモート実行など)に焦点を当てることもできます。

すべての SIG が同じレベルのエネルギー、範囲の広さ、ガバナンス モデルを持つわけではありませんが、インタレスト グループが設立された場合に、積極的に参加して貢献するコミュニティ メンバーがいることを示す十分な証拠が必要です。参加する前に、グループの作業内容を確認し、SIG リーダーに連絡してください。メンバーシップ ポリシーは SIG ごとに異なります。

Bazel SIG の完全なリストをご覧ください

目標外: SIG でないもの

SIG は、共有作業でのコラボレーションを促進することを目的としています。したがって、SIG は次のようになります。

  • サポート フォーラムではない :メーリング リストと SIG は同じものではありません
  • すぐに必要ではない :プロジェクトの初期段階では、共有作業や共同作業者がいるかどうかわからない場合があります
  • 無料の労働力ではない :コラボレーションによる作業の成長と調整にはエネルギーが必要です

Bazel のオーナーは、SIG の作成に慎重なアプローチを取っています。GitHub でプロジェクトを簡単に開始できるため、SIG を必要とせずにコラボレーションを行う方法はたくさんあります。

SIG のライフサイクル

このセクションでは、SIG を作成する方法について説明します。

調査とコンサルテーション

新しい SIG グループを提案するには、まず、以下に示すように承認の証拠を集めます。検討すべき方法としては、次のようなものがあります。

  • グループが解決する明確に定義された問題または一連の問題
  • メリットを受けるコミュニティ メンバーとのコンサルテーション。メリットとコミットする意欲の両方を評価する
  • 既存のプロジェクトの場合、コントリビューターがトピックに関心を持っていることを示す Issue と PR の証拠
  • グループが達成できる可能性のある目標
  • グループの実行に必要なリソース

SIG の必要性が自明のように思われる場合でも、グループの成功には調査とコンサルテーションが重要です。

新しいグループを作成する

新しいグループは、憲章の作成について以下のプロセスに従う必要があります。特に、次のことを示す必要があります。

  • Bazel の明確な目的とメリット(サブプロジェクトまたはアプリケーション領域に関するもの)
  • グループ リーダーとして行動する意思のある 2 人以上のコントリビューター、他のコントリビューターの存在、グループの需要の証拠
  • 各グループは、一般公開されているメーリング リストを少なくとも 1 つ使用する必要があります。SIG は、bazel-discuss などの公開リストのいずれかを再利用したり、@bazel.build のリストをリクエストしたり、独自のリストを作成したりできます。
  • SIG が最初に必要とするリソース(通常はメーリング リストと定期的なビデオ通話)。
  • SIG は、ディレクトリからドキュメントとファイルを提供できます。 bazelbuild/community または、 bazelbuild GitHub 組織内の独自のリポジトリから提供できます。SIG は、bazelbuild GitHub 組織外で作業を整理する場合、外部リソースにリンクできます。
  • Bazel のオーナーは、SIG の申請を承認または拒否し、必要に応じて他の関係者と協議します。

プロセスの正式な部分に入る前に、product@bazel.build で Bazel プロダクト チームに相談してください。ほとんどの SIG では、承認前に会話と反復処理が必要です。

新しいグループの正式なリクエストは、 bazelbuild/community に PR として憲章を送信し、 以下のテンプレートに沿って PR のコメントにリクエストを含めることで行います。承認されると、グループの PR がマージされ、必要なリソースが作成されます。

新しい SIG のテンプレート リクエスト

新しい SIG をリクエストするには、コミュニティ リポジトリのテンプレート( SIG-request-template.md)を使用します。

憲章の作成

グループを設立するには、憲章が必要であり、Bazel 行動規範に従う必要があります。 グループのアーカイブは公開されます。メンバーシップは、承認なしで誰でも参加できるか、グループ管理者の承認を保留してリクエストに応じて利用できるかのいずれかになります。

憲章では管理者を指名する必要があります。管理者だけでなく、グループには少なくとも 1 人のリーダー(同じ人物でも可)を含める必要があります。このリーダーは、Bazel プロダクト チームとの調整が必要な場合の連絡窓口となります。

グループの作成者は、グループのメーリング リストに憲章を投稿する必要があります。Bazel GitHub 組織のコミュニティ リポジトリには、このようなドキュメントとポリシーがアーカイブされます。グループが慣行や規則を進化させるにつれて、コミュニティ リポジトリの関連部分で憲章を更新する必要があります。

コラボレーションとインクルージョン

必須ではありませんが、グループは会議を行うために、スケジュールされた電話会議やチャット チャネルでのコラボレーションを利用することを選択する必要があります。このような会議はメーリング リストで告知し、議事録は後でメーリング リストに投稿する必要があります。定期的な会議は、SIG の説明責任と進捗を促進するのに役立ちます。

Bazel プロダクト チームのメンバーは、必要に応じてグループを積極的にモニタリングし、ディスカッションや行動を促すことができます。

SIG を立ち上げる

必要なアクティビティ:

  • Bazel の一般的なディスカッション グループ (bazel-discussbazel-dev)に通知します。

省略可能なアクティビティ:

  • Bazel ブログのブログ投稿を作成する

SIG の健全性と終了

Bazel のオーナーは、SIG の健全性を確保するために最善を尽くします。Bazel のオーナーは、SIG の活動をより広範な Bazel コミュニティに知らせるために、SIG リーダーに SIG の作業について報告を求めることがあります。

SIG が有用な目的や関心のあるコミュニティを持たなくなった場合は、アーカイブして運用を停止できます。Bazel プロダクト チームは、プロジェクト全体の健全性を維持するために、このような非アクティブな SIG をアーカイブする権利を有していますが、これは望ましくない結果です。SIG は、有用な期間が終了したと判断した場合、解散することもできます。

このコンテンツは、Tensorflow の SIG プレイブックを 修正して採用したものです。