Bazel は Special Interest Groups(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 に対する明確な目的と利点(サブプロジェクトまたはアプリケーション領域に関するもの)
- グループ リードとして行動する意思のある 2 人以上のコントリビューター、他のコントリビューターの存在、グループに対する需要の証拠
- 各グループは、一般公開されているメーリング リストを少なくとも 1 つ使用する必要があります。SIG は、bazel-discuss などの公開リストを再利用したり、@bazel.build のリストを要求したり、独自のリストを作成したりできます。
- SIG で最初に必要となるリソース(通常はメーリング リストと通常のビデオ通話)。
- SIG は、
bazelbuild/community
のディレクトリ、またはbazelbuild
GitHub の独自のリポジトリから、ドキュメントやファイルを提供できます。 101}組織 SIG は、bazelbuild
GitHub 組織外で作業を整理する場合、外部リソースにリンクできます - Bazel オーナーは SIG アプリケーションを承認または拒否し、必要に応じて他のステークホルダーにコンサルトします。
プロセスの正式な部分に入る前に、Bazel プロダクト チーム(product@bazel.build)にコンサルトしてください。ほとんどの SIG は、承認前に会話とイテレーションを必要とします。
新しいグループに対する正式なリクエストは、チャーターとして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 ハンドブックに修正を加えたものです。