プルリクエスト／イシューマネージャーの責務

D言語財団は、Symmetry Investmentsの後援により、2名のパートタイムのプル・リクエスト・マネージャーを雇用している。 シンメトリー・インベストメンツのスポンサーシップにより、2名の非常勤プルリクエストマネージャーを雇用している。そのうちの一人は、事務的・管理的な役割を担っている。 もう一人は、より技術志向の役割である。この このドキュメントは、Dプログラミング言語Gに提出されたプルリクエストを管理する際の、彼らの一般的な責務について概説したものである。 Github "プログラミング言語"組織リポジトリに提出された 組織リポジトリ、issues.dlang.orgに提出された課題の管理に関する一般的な責任を概説している。

これらの役職を設けた第一の目的は、貢献プロセスを合理化することである。 貢献プロセスを合理化することである。私たちは、IssueやPRのメンテナンスを行ってくれているボランティアに感謝している。 過去数年間、issueキューとPRキューを管理してくれていたボランティアに感謝している。 私たちのプロセスの緩やかな性質は、あまりにも多くの貢献が陳腐化してしまう (誰も関心を持たず、一人のメンテナにボトルネックになるなど)。 貢献者は、バグ報告であれ、コンテンツへの貢献であれ、自分の投稿がレビューされ、その内容が反映されるという確信を持つべきである。 投稿者は、バグ報告であれコンテンツへの貢献であれ、自分の投稿がレビューされ、結論に導かれるという確信を持つべきである。 長期間滞留することなく。有給のスタッフがプロセスを監督することで 有給のスタッフがプロセスを監督することで、プロセスがより効率的になり、"貢献者"はサポートする主要な窓口を持つことができる。 投稿者は、投稿の追跡と解決を支援する主要な窓口を持つことになる。 を持つことになる。

以下のリストは、管理部門と技術部門に分かれている。 の責任に分けられる。いくつかは重複しているかもしれないし、他のものとの境界が緩いかもしれない。 の間に緩やかな境界があるかもしれない。私たちは、PRマネージャーがこれらの責任を果たすための独自のアプローチを確立することを信じている。 これらの責任を遂行するための独自のアプローチを確立することを信頼する。

以下の文章では、APRはアドミニストレーティブPRマネージャーの役割、TPRはテクニカルPRマネージャーの役割を指す。

管理部門の責任

効果的に責任を果たすために、APRは以下のことを認識する必要がある。 どの中心的貢献者がどの分野に責任を持つか、また、解決するために必要なときにどのコミュニティメンバーに連絡すべきかを認識する必要がある。 問題を解決するために必要なときにどのコミュニティメンバーに連絡すべきかを認識する必要がある。 言語とエコシステムの一般的な方向性を理解する必要がある。 (すなわち、APRはどのようなPRであっても、"Do we do this?"という質問に答えられる必要がある)。 という問いに答えられるべきである)。

• コントリビューションガイドを維持する。 コントリビューションガイドは、課題やプルリクエストを提出するためのベストプラクティスを確立する。APRは APRはTPRと協力して、必要に応じてこれらの詳細を進化させ、ドキュメントが最新であることを保証する。 ドキュメントを最新のものにする。
• 課題とPRのトリアージ- 各課題レポートが適切に優先順位付けされ、可能であればプルリクエストが提出されるようにする。 優先順位をつけ、可能であれば解決できる人に割り当てる; プルリクエストがマージされる前に、適切なレビューのために必要な時間を確保するための基準を確立する。 プルリクエストがマージされる前に、適切なレビューのために必要なだけの時間を確保するための基準を設ける(例えば、些細なものか複雑なものか、 課題/PRをクローズする基準を確立する; プルリクエストが最初にDIPとして取り込まれるべきタイミングを認識する。
• 進捗を把握する- APRは、次のような何らかの手段を確立すべきである。 APRは、システム内のすべての課題やPRの最新状況を把握するための何らかの手段を確立すべきである。 また、APRは、課題やPRのステータスに関する問い合わせの主要な窓口となる。 課題または PR の状況に関する問い合わせの主要な窓口となる。
• 関連当事者とのコミュニケーション- コミュニケーションは、以下にとって不可欠である。 課題およびプルリクエストの効率的な処理を保証する。貢献者 自発的に取り上げられない問題を解決するために、貢献者を探す必要がある。 自明でないプルリクエストは、適切なコア貢献者/メンテナによってレビューされる必要がある。 非自明なプルリクエストは、適切なコア貢献者/メンテナーがレビューする必要がある。 貢献者は、迅速に解決できない場合、自分の貢献の状況を常に把握する必要がある。 などである。

技術的責任

この役割の責任を効果的に果たすために、TPRは以下のことを行う。 GitHub プロジェクトのアーキテクチャをしっかり理解している必要がある、 どの PR に対しても、TPR は "Can we do this? という質問に答えられる必要がある。)

• コントリビューションガイドを遵守する。 コントリビューションガイドを遵守する。 ガイドラインに従う。TPRは貢献者と協力して、これらのガイドラインが満たされていることを確認する。 (テストケースの削減、適切なコミットメッセージのフォーマット、変更履歴)、 マージの衝突を解決する、など)。
• リグレッションを特定し、解決する。 が報告されることがある。TPRはそのようなバグを特定する。 報告されたすべてのリグレッションの原因を突き止め、それを解決するための手段を講じる。 解決するためのステップを踏む(例えば、問題のあるPRの作者/レビュアーに連絡する)。 など)。
• 些細なPRをレビューする。 をTPRがレビューし、マージする。
• 些細な問題を修正する - TPRは些細な問題を自由に修正し、プルリクエストとして提出することができる。 プルリクエストとして提出することができる。 レビュアーにレビューを依頼しなければならない。