ロールと責任

誰もがKubernetesに貢献することができます。 SIG Docs へのコントリビューションが増えると、コミュニティ内で異なるレベルのメンバーシップに申請することができます。 これらの役割により、コミュニティ内でより多くの責任を担うことができます。 各役割にはより多くの時間とコミットメントが必要です。 役割は以下の通りです:

  • Anyone: Kubernetesドキュメントへの定期的なコントリビューター
  • Member: Issueの割り当てとトリアージができ、Pull Requestに対する非公式なレビューができる
  • Reviewer: ドキュメントのPull Requestのレビューをリードし、変更の品質を保証する
  • Approver: ドキュメントのレビューをリードし、変更をマージできる

Anyone

GitHubのアカウントを持っている人なら誰もがKubernetesに貢献することができます。 SIG Docs はすべての新たなコントリビューターを歓迎します。

誰もが以下のことをできます:

CLA に署名した後は、誰もが以下のことをできます:

  • 既存のコンテンツを改善するためのPull Requestを開く、新しいコンテンツを追加する、ブログ記事やケーススタディを書く
  • 図表やグラフィックアセット、埋め込み可能なスクリーンキャストやビデオを作成する

詳細については、新しいコンテンツの貢献を参照してください。

Member

Memberは、kubernetes/websiteに複数のPull Requestを作成した人です。 MemberはKubernetes GitHub organizationの一員です。

Memberは以下のことをできます:

  • Anyoneに列挙されているすべてのことを行う

  • /lgtmコメントを使用して、Pull RequestにLGTM (looks good to me)ラベルを追加する

  • /holdコメントを使用して、Pull Requestのマージをブロックする

  • /assignコメントを使用して、Pull RequestにReviewerを割り当てる

  • Pull Requestに非公式なレビューを提供する

  • 自動化を使用してIssueをトリアージし、分類する

  • 新機能をドキュメント化する

Memberになる

少なくとも5つの実質的なPull Requestを作成し、その他の要件を満たした後に以下のようにしてMemberになることができます:

  1. 2人のReviewerまたはApproverにあなたのメンバーシップをスポンサーしてもらいます。

    Slackの#sig-docsチャンネルSIG Docsのメーリングリストでスポンサーを依頼してください。

  2. kubernetes/orgリポジトリにIssueを作成します。Organization Membership Requestのissueテンプレートを使用してください。

  3. スポンサーにGitHub Issueのことを知らせます。以下の方法があります:

    • Issue内でGitHubユーザー名に言及する(@<GitHub-username>

    • Slackやメールを使ってIssueのリンクを送る

      スポンサーは+1の投票でリクエストを承認します。 スポンサーがリクエストを承認すると、Kubernetes GitHubの管理者があなたをメンバーとして追加します。 おめでとうございます!

      メンバーシップリクエストが承認されない場合はフィードバックを受け取ります。 フィードバックに対応した後、再度申請してください。

  4. メールアカウントでKubernetes GitHub organizationの招待を受け入れます。

Reviewer

ReviewerはオープンなPull Requestのレビューを担当します。 Memberのフィードバックとは異なり、PRを作成した人はReviewerのフィードバックに対応する必要があります。 Reviewerは@kubernetes/sig-docs-{language}-reviews GitHubチームのメンバーです。

Reviewerは以下のことをできます:

  • AnyoneおよびMemberに列挙されているすべてのことを行う

  • Pull Requestをレビューし、拘束力のあるフィードバックを提供する

  • コード内のユーザー向けの文字列を編集する

  • コードコメントを改善する

SIG DocsのReviewer、あるいは特定の領域に関するドキュメントのReviewerになることができます。

Pull RequestへのReviewerの割り当て

自動化により、すべてのPull RequestにReviewerが割り当てられます。 特定の人物にレビューを依頼するには、/assign [@_github_handle]とコメントします。

割り当てられたReviewerがPRにコメントしていない場合、他のReviewerが代わりにレビューできます。 また、必要に応じて技術的なReviewerを割り当てることもできます。

/lgtmの使用

LGTMは"Looks good to me"の略で、Pull Requestが技術的に正確でマージの準備が整っていることを示します。 すべてのPRには、マージするためにReviewerからの/lgtmコメントとApproverからの/approveコメントが必要です。

Reviewerからの/lgtmコメントは拘束力があり、自動化によりlgtmラベルが追加されます。

Reviewerになる

要件を満たすと、SIG DocsのReviewerになることができます。他のSIGのReviewerは、SIG DocsでのReviewerステータスを別途申請する必要があります。

申請方法は以下の通りです:

  1. kubernetes/websiteリポジトリのOWNERS_ALIASESファイルのセクションに、GitHubユーザー名を追加するPull Requestを開きます。

  2. PRを1人以上のSIG Docs Approverに割り当てます(ユーザー名はsig-docs-{language}-ownersに記載されています)。

承認されると、SIG Docsのリードが適切なGitHubチームに追加します。 追加されると、k8s-ci-robotが新しいPull RequestのReviewerとしてあなたを割り当て、提案します。

Approver

ApproverはPull Requestをレビューし、マージするために承認します。 Approverは@kubernetes/sig-docs-{language}-owners GitHubチームのメンバーです。

Approverは以下のことをできます:

  • AnyoneMember、およびReviewerに列挙されているすべてのことを行う
  • /approveコメントを使用してPull Requestを承認およびマージすることで、コントリビューターのコンテンツを公開する
  • スタイルガイドの改善を提案する
  • ドキュメントテストの改善を提案する
  • Kubernetesのウェブサイトや他のツールの改善を提案する

PRに既に/lgtmが付いている場合、またはApprover自身が/lgtmコメントを付けた場合、PRは自動的にマージされます。 SIG DocsのApproverは、追加の技術的なレビューが不要な変更にのみ/lgtmを付けるべきです。

Pull Requestの承認

ApproverとSIG DocsのリードだけがPull Requestをwebsiteリポジトリにマージすることができます。 これには一定の責任が伴います。

  • Approverは/approveコマンドを使用して、PRをリポジトリにマージできます。

  • 提案された変更がドキュメントコンテンツガイドに準拠していることを確認してください。

    もし疑問がある場合や何か不明な点がある場合は、遠慮なく追加のレビューを依頼してください。

  • PRを/approveする前に、Netlifyのテストに通っていることを確認してください。

    Netlifyテストは承認する前に通っている必要があります
  • 承認する前に、PRのNetlifyのページプレビューをクリックして内容が正しいことを確認してください。

  • 週ごとのローテーションであるPR Wranglerローテーションスケジュールに参加してください。SIG DocsはすべてのApproverにこのローテーションへの参加を期待しています。詳細についてはPR wranglersを参照してください。

Approverになる

要件を満たすと、SIG DocsのApproverになることができます。 他のSIGのApproverは、SIG DocsでのApproverステータスを別途申請する必要があります。

申請方法は以下の通りです:

  1. kubernetes/websiteリポジトリのOWNERS_ALIASESファイルのセクションに、自分自身を追加するPull Requestを開きます。

  2. PRを1人以上の現在のSIG Docs Approversに割り当てます。

承認されると、SIG Docsのリードが適切なGitHubチームに追加します。 追加されると、k8s-ci-robotが新しいPull RequestのReviewerとしてあなたを割り当て、提案します。

次の項目

  • すべてのApproverがローテーションで担当する役割であるPR wranglingについて読む。