自分の変更を他のユーザーが確認できるようにする

Pull request を作成したら、変更を確認してフィードバックを提供するようにチームに依頼します。このガイドでは、レビューが容易でチームに常に情報を提供できる pull request を作成するためのベストプラクティスについて説明します。これにより、コラボレーションとレビューの質を高めることができます。

変更を簡単に確認できるようにする

Pull request 内のコンテキストを明確にすると、変更した内容とそれが重要な理由をレビュー担当者がすぐに把握できます。その結果、レビュープロセスが迅速かつスムーズになり、やり取りの回数が減り、チームがより良いフィードバックを提供し、自信を持って判断を下せるようになります。 Pull request の作成の詳細については、「pull request の作成」を参照してください。

小さい PR を書き込む

1 つの目的を満たす、焦点を絞った小さな pull request を作成することを目的とします。 pull request を小さくすると、レビューとマージが簡単かつ迅速になり、バグを導入する余地が少なくなり、変更の履歴がより明確になります。

最初に独自の pull request を確認する

送信する前に、独自の pull request を確認、ビルド、テストします。これにより、他のユーザーがレビューを開始する前に、見逃した可能性のあるエラーや入力ミスをキャッチできます。

コンテキストとガイダンスを提供する

pull request の内容をレビュー担当者がすぐに理解できるように、pull request の明確なタイトルと説明を記述します。 pull request の本文は次のようになります。

pull request の目的
変更点の概要
問題の追跡や以前の会話など、追加のコンテキストへのリンク

レビュー担当者を支援するには、必要なフィードバックの種類を共有します。たとえば、ざっと見るだけでよいでしょうか、それとも深い批評が必要でしょうか。さらに、GitHub Copilot を使って pull request の要約を生成することもできます。この記事の後半の「GitHub Copilot を使って pull request の概要を生成する」を参照してください。

pull request が複数のファイルに対する変更で構成されている場合は、ファイルをレビューする順序に関するガイダンスをレビュー担当者に提供します。開始する場所とレビューを続行する方法を勧めます。

チームに常に情報を提供する

Pull request は、コードの変更を文書化するだけでなく、自分の作業状況をチームやマネージャーに常に知らせることができる強力な方法でもあります。 Pull request で進行状況を視覚化することで、個別に更新する必要性を減らし、全員が足並みを揃えることができます。

GitHub Copilot を使って pull request の概要を生成する

Note

GitHub Copilot のサブスクリプションが必要です。詳しくは、「GitHub Copilot とは何ですか?」を参照してください。

Copilot を使用して、GitHub に対する pull request の概要を生成できます。要約を使うと、自分の変更内容をレビュー担当者が把握するために役立ちます。

GitHub で、pull request を作成するか、既存の pull request に移動します。

Note

GitHub Copilot では、pull request の説明に含まれる既存の内容は考慮されないため、説明を空白にしてから開始するのがベストです。
pull request の概要を追加するテキストフィールドに移動します。
- 新しい pull request を作成する場合は、[説明の追加] フィールドを使用します。
- 既存の pull request に説明を追加する場合は、開始コメントを編集します。
- 概要をコメントとして追加する場合は、pull request ページの下部にある [コメントの追加] セクションに移動します。
テキストフィールドのヘッダーで、を選択し、[概要] をクリックします。
GitHub Copilot が概要を生成するまで待ってから、結果を慎重にチェックします。
pull request を閲覧するユーザーに役立つコンテキストを追加します。
説明に問題がない場合は、新しい pull request で [pull request の作成] をクリックし、既存の説明を編集する場合は、[コメントの更新] をクリックします。

Pull request を関連する issue やプロジェクトボードに接続して、自分の作業がより大きなプロジェクトの中でどのような位置付けになるかを確認します。

説明に Closes ISSUE-LINK のようなキーワードを追加すると、pull request のマージ時に issue が自動的にリンクされ、終了されます。
Projects を使って作業を追跡し、pull request からプロジェクトにリンクすると、進行状況を 1 か所で簡単に追跡できます。「Projects について」を参照してください。

状態をラベルで強調表示する

レビューの準備ができている、ブロックされている、または進行中であることを示す状態ラベルを pull request に追加します。こうすることで、レビュー担当者は作業の状態を一目で理解できるようになります。詳しくは、「ラベルを管理する」をご覧ください。

自分の変更を他のユーザーが確認できるようにする

この記事の内容