ロールと責任
誰もがKubernetesに貢献することができます。 SIG Docs へのコントリビューションが増えると、コミュニティ内で異なるレベルのメンバーシップに申請することができます。 これらの役割により、コミュニティ内でより多くの責任を担うことができます。 各役割にはより多くの時間とコミットメントが必要です。 役割は以下の通りです:
- Anyone: Kubernetesドキュメントへの定期的なコントリビューター
- Member: Issueの割り当てとトリアージができ、Pull Requestに対する非公式なレビューができる
- Reviewer: ドキュメントのPull Requestのレビューをリードし、変更の品質を保証する
- Approver: ドキュメントのレビューをリードし、変更をマージできる
Anyone
GitHubのアカウントを持っている人なら誰もがKubernetesに貢献することができます。 SIG Docs はすべての新たなコントリビューターを歓迎します。
誰もが以下のことをできます:
kubernetes/website
を含む、どのKubernetesリポジトリでもIssueを作成する- Pull Requestに非公式なフィードバックを提供する
- ローカライゼーションに貢献する
- Slackや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)ラベルを追加する備考:
/lgtm
を使用すると、自動化がトリガーされます。 非公式に承認したい場合は、"LGTM"とコメントするだけでも大丈夫です!/hold
コメントを使用して、Pull Requestのマージをブロックする/assign
コメントを使用して、Pull RequestにReviewerを割り当てるPull Requestに非公式なレビューを提供する
自動化を使用してIssueをトリアージし、分類する
新機能をドキュメント化する
Memberになる
少なくとも5つの実質的なPull Requestを作成し、その他の要件を満たした後に以下のようにしてMemberになることができます:
2人のReviewerまたはApproverにあなたのメンバーシップをスポンサーしてもらいます。
Slackの#sig-docsチャンネルやSIG Docsのメーリングリストでスポンサーを依頼してください。
備考:
個別のSIG Docsメンバーに直接メールやSlackのダイレクトメッセージを送らないでください。 また申請する前にスポンサーを依頼する必要があります。kubernetes/org
リポジトリにIssueを作成します。Organization Membership Requestのissueテンプレートを使用してください。スポンサーにGitHub Issueのことを知らせます。以下の方法があります:
Issue内でGitHubユーザー名に言及する(
@<GitHub-username>
)Slackやメールを使ってIssueのリンクを送る
スポンサーは
+1
の投票でリクエストを承認します。 スポンサーがリクエストを承認すると、Kubernetes GitHubの管理者があなたをメンバーとして追加します。 おめでとうございます!メンバーシップリクエストが承認されない場合はフィードバックを受け取ります。 フィードバックに対応した後、再度申請してください。
メールアカウントでKubernetes GitHub organizationの招待を受け入れます。
備考:
GitHubはアカウントのデフォルトメールアドレスに招待を送信します。
Reviewer
ReviewerはオープンなPull Requestのレビューを担当します。 Memberのフィードバックとは異なり、PRを作成した人はReviewerのフィードバックに対応する必要があります。 Reviewerは@kubernetes/sig-docs-{language}-reviews GitHubチームのメンバーです。
Reviewerは以下のことをできます:
Pull Requestをレビューし、拘束力のあるフィードバックを提供する
備考:
拘束力のないフィードバックを提供する場合、コメントの前に"Optionally: "などのフレーズを付けてください。コード内のユーザー向けの文字列を編集する
コードコメントを改善する
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ステータスを別途申請する必要があります。
申請方法は以下の通りです:
kubernetes/website
リポジトリのOWNERS_ALIASESファイルのセクションに、GitHubユーザー名を追加するPull Requestを開きます。備考:
どこに追加すればよいかわからない場合は、
sig-docs-en-reviews
に追加してください。訳注:
sig-docs-en-reviews
は英語版のReviewerチームです。日本語ローカライゼーションのReviewerチームに参加する場合は、sig-docs-ja-reviews
に追加してください。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は以下のことをできます:
- Anyone、Member、および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のテストに通っていることを確認してください。承認する前に、PRのNetlifyのページプレビューをクリックして内容が正しいことを確認してください。
週ごとのローテーションであるPR Wranglerローテーションスケジュールに参加してください。SIG DocsはすべてのApproverにこのローテーションへの参加を期待しています。詳細についてはPR wranglersを参照してください。
Approverになる
要件を満たすと、SIG DocsのApproverになることができます。 他のSIGのApproverは、SIG DocsでのApproverステータスを別途申請する必要があります。
申請方法は以下の通りです:
kubernetes/website
リポジトリのOWNERS_ALIASESファイルのセクションに、自分自身を追加するPull Requestを開きます。備考:
どこに追加すればよいかわからない場合は、`sig-docs-en-owners`に追加してください。 訳注: `sig-docs-en-owners`は英語版のApproverチームです。 日本語ローカライゼーションのApproverチームに参加する場合は、`sig-docs-ja-owners`に追加してください。
PRを1人以上の現在のSIG Docs Approversに割り当てます。
承認されると、SIG Docsのリードが適切なGitHubチームに追加します。 追加されると、k8s-ci-robotが新しいPull RequestのReviewerとしてあなたを割り当て、提案します。
次の項目
- すべてのApproverがローテーションで担当する役割であるPR wranglingについて読む。