Bazel は、Special Interest Group(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 組織の独自のリポジトリからドキュメントとファイルを提供できます。SIG は、bazelbuild
GitHub 組織外で作業を整理することを選択した場合に、外部リソースにリンクできます。 - Bazel オーナーは、SIG アプリケーションを承認または却下し、必要に応じて他の関係者にコンサルトする
プロセスの正式な部分に入る前に、Bazel プロダクト チーム(product@bazel.build)に相談する必要があります。ほとんどの SIG では、承認前に会話とイテレーションが必要です。
新しいグループの正式なリクエストを行うには、PR として趣意書を PR として bazelbuild/community
に送信し、そのリクエストを以下のテンプレートに従って PR のコメントに含めます。承認されると、グループの PR がマージされ、必要なリソースが作成されます。
新しい SIG のテンプレート リクエスト
新しい SIG をリクエストするには、コミュニティ リポジトリにあるテンプレート(SIG-request-template.md)を使用します。
チャーター
グループを設定するには、憲章が必要です。Bazel の行動規範に従ってください。グループのアーカイブは公開されます。メンバーシップは、承認なしに誰でも開くことも、グループ管理者の承認を待たずにリクエストに応じて利用可能にすることもできます。
趣意書は管理者を指名する必要があります。管理者だけでなく、このグループに 1 人以上のリーダー(同じ人物を含む)も含める必要があります。この人物は、Bazel プロダクト チームとの調整に必要な連絡窓口となります。
グループの作成者は、自身のグループ メーリング リストに趣意書を投稿する必要があります。Bazel GitHub GitHub コミュニティのコミュニティ リポジトリは、そのようなドキュメントとポリシーをアーカイブしています。グループは慣習や規則を発展させるように、コミュニティ リポジトリの関連する部分で趣意を定めたものにする必要があります。
コラボレーションとインクルージョン
強制ではありませんが、そのグループは、スケジュールされた電話会議またはチャット チャネルを介して会議を利用し、会議を行う必要があります。このような会議は、メーリング リストに掲載し、後でメーリング リストにメモを書き込んでください。定期的にミーティングを行うことで、SIG のアカウンタビリティと進捗状況を高めることができます。
Bazel プロダクト チームのメンバーは、積極的にグループをモニタリングして、必要に応じてグループにディスカッションと対応を促すことができます。
SIG を起動する
必須事項:
- Bazel の一般ディスカッション グループ(bazel-discuss、bazel-dev)に通知します。
オプションのアクティビティ:
- Bazel ブログのブログ投稿を作成する
SIG の健全性と終了
Bazel のオーナーは、SIG の健全性を確保するために最善を尽くします。Bazel のオーナーは、SIG の取り組みについて報告するよう SIG リードにリクエストし、より広範な Bazel コミュニティにグループのアクティビティを通知します。
SIG に有用な目的や関心のあるコミュニティがなくなったら、SIG がアーカイブされ、運用が停止される可能性があります。Bazel プロダクト チームは、プロジェクト全体の健全性を維持するために、このような非アクティブな SIG をアーカイブする権利を有していますが、望ましい結果ではありません。SIG では、耐用年数が経過したことを認識した場合、放棄することもあります。
注
このコンテンツは Tensorflow の SIG ハンドブックから改訂されたもので、修正されています。