1 - Issueのトリアージガイドライン
目的
Issueの管理を迅速に行います。
etcdのIssueは https://github.com/etcd-io/etcd/issues
に一覧があり、
ラベルで分類されています。たとえば、バグと判断されたIssueには、
最終的にarea/bug ラベルが付けられます。新しいIssueには当初ラベルがありませんが、
通常はetcdのメンテナーや活発に活動する貢献者が調査結果に基づいて追加します。
ラベルの詳細な一覧は https://github.com/kubernetes/kubernetes/labels
を参照してください。
便利なIssue検索へのリンクをいくつか挙げます。
対象範囲
このガイドラインは、etcdに新たに報告されたIssueをトリアージするための基本文書です。IssueやPRの管理への協力は誰でも歓迎しますが、ここで説明する作業と責任は、etcdのメンテナーや活発に活動する貢献者を想定しています。
Issueがバグかどうかの確認
報告された問題が実際にバグかどうかを確認します。バグでない場合は調査結果をコメントし、軽微なIssueならクローズします。軽微でない場合は、報告者からの返答を待ち、異議がないかを確認します。報告者が30日以内に返答しなければ、Issueをクローズします。問題を再現できない場合や追加情報が必要な場合は、報告者に向けてコメントを残します。
動きのないIssue
報告者からの情報が不足しているIssueは、60日以内に情報が提供されなければクローズすることを推奨します。
重複するIssue
Issueが重複している場合は、その旨と元のIssueへの参照をコメントし、クローズします。
etcdに属さないIssue
etcdが使用している他のプロジェクトの問題が報告されることがあります。たとえば、grpcやgolangの問題です。このような場合は、適切なプロジェクトでIssueを作成するよう報告者に依頼することを推奨します。メンテナーと報告者が追跡のために残す必要があると考える場合を除き、Issueをクローズします。
重要なラベルの確認
Issueに該当領域のラベルが付き、適切な担当者が割り当てられ、マイルストーンが決まっていることを確認します。必要なラベルが欠けていれば追加します。権限不足でラベルを付けられない場合や適切なラベルを判断できない場合は、無理に対応する必要はありません。必要に応じてメンテナーに連絡してください。
必要に応じた担当者への確認
開発者が担当しているIssueで30日経ってもPRが作成されていない場合は、担当者に連絡し、PRの作成、または必要に応じて担当を外れることを依頼します。
2 - PRの管理
目的
PRの管理を迅速にすること。
etcdのPRは https://github.com/etcd-io/etcd/pulls
に一覧表示されています。
PRにはさまざまなラベル、マイルストーン、レビュアーなどを設定できます。ラベルの詳細な一覧は、次のページを参照してください。
https://github.com/kubernetes/kubernetes/labels
便利なPR検索の例を以下に示します。
対象範囲
このガイドラインは、etcdでPRを管理する際の基本となるドキュメントです。PRの管理への協力はどなたでも歓迎しますが、このドキュメントで扱う作業と責任は、etcdのメンテナーと積極的に活動するコントリビューターを想定しています。
動きのないPRへの対応
レビューコメントに15日間対応がない場合は、PRの作成者に確認を促してください。PRの作成者から90日間返信がない場合は、可能であれば新しいコミットでPRを更新してください。それができなければ、動きのないPRは180日後にクローズするべきです。
必要に応じてレビュアーに確認を促す
レビュアーは適時に応答していますが、全員が忙しいことを考慮し、レビューを依頼してすぐに応答がなくても、しばらく待ってください。10日間応答がなければ、PRへのコメントの追加、メールの送信、Slackでのメッセージ送信によって連絡して構いません。
重要なラベルが付いていることを確認する
PRに適切なレビュアーが追加されていることを確認してください。また、マイルストーンが指定されていることも確認してください。これらの項目やその他の重要なラベルが不足していれば追加してください。適切なラベルを判断できない場合は、必要に応じてメンテナーに対応を依頼するコメントを残してください。