Bazel は、特定の
分野でのコラボレーションに重点を置き、Bazel のオーナー、
メンテナー、コントリビューター間のコミュニケーションと調整をサポートするために、特別関心グループ(SIG)をホストしています。このポリシー
は bazelbuildに適用されます。
SIG は公開で作業を行います。SIG の理想的な範囲は、参加者の大半がコミュニティである、明確に定義された
ドメインを対象とします。SIG は、bazelbuild のコミュニティ管理リポジトリ(言語ルールなど)に焦点を当てることも、Bazel リポジトリのコード領域(リモート実行など)に焦点を当てることもできます。
すべての SIG が同じレベルのエネルギー、範囲の広さ、または ガバナンス モデルを持つわけではありませんが、関心グループが 設立された場合に、参加して貢献する意欲のあるコミュニティ メンバーがいることを示す十分な証拠が必要です。参加する前に、グループの作業内容を確認し、SIG リーダーに 連絡してください。メンバーシップ ポリシーは 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または、bazelbuildGitHub 組織内の独自のリポジトリから提供できます。SIG は、 GitHub 組織外で作業を整理する場合、外部リソースにリンクできます。bazelbuild - 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-discuss、 bazel-dev)に通知します。
省略可能なアクティビティ:
- Bazel ブログのブログ投稿を作成する
SIG の健全性と終了
Bazel のオーナーは、SIG の健全性を確保するために最善を尽くします。Bazel のオーナーは、グループの活動をより広範な Bazel コミュニティに知らせるために、SIG リーダーに SIG の作業に関するレポートをリクエストすることがあります。
SIG が有用な目的や関心のあるコミュニティを持たなくなった場合は、アーカイブして運用を停止できます。Bazel プロダクト チームは、プロジェクト全体の健全性を維持するために、 このような非アクティブな SIG をアーカイブする権限を有していますが、 これは望ましくない結果です。SIG は、 有用な期間が終了したと判断した場合、解散することもできます。
注
このコンテンツは、Tensorflow の SIG プレイブック を基に作成され、変更が加えられています。