pull request を処理する

プル要求 (PR) を開くと、PR は一連のチェックとレビューを受け取り、提案された変更をマージできることを確認します。 PR の詳細な背景については、Git と GitHub の基礎を参照してください。

検証

PR をターゲット ブランチにマージする前に、1 つ以上の PR 検証プロセスを通過することが必要になる場合があります。 [プル要求の作成] を選択すると、GitHub によってリポジトリ用に構成された検証が実行されます。 検証プロセスが完了すると、結果が PR に表示されます。

検証プロセスは、提案された変更の範囲、および宛先リポジトリのルールによって異なります。 PR を送信すると、次のうち 1 つ以上が発生することが予想されます。

• マージ可能性: ブランチ内の提案された変更が宛先ブランチと競合するかどうかを検証する、ベースライン GitHub マージ可能性テストがまず実行されます。 このテストで不合格になったと PR に表示された場合、処理を続行する前に、マージ競合の原因となっているコンテンツを調整する必要があります。
• 貢献者使用許諾契約書 (CLA): Microsoft 以外の共同作成者として、パブリック リポジトリに投稿している場合は、そのリポジトリに PR を初めて送信するときに短い CLA を完了するように求められる場合があります。 CLA 手順がクリアされると、PR が処理されます。
• ラベル付け:ラベルは PR に自動的に適用され、検証ワークフローの通過に応じた PR の状態を示します。 たとえば、新しい PR は、PR が検証、レビュー、サインオフの手順をまだ完了していないことを示す "do-not-merge" ラベルを自動的に受け取る場合があります。
• 検証とビルド: 自動化されたチェックにより、変更内容が検証テストに合格するかどうかが確認されます。 検証テストは、PR をマージする前にその中の 1 つ以上のファイルを編集することを求める警告またはエラーを出力する場合があります。 検証テストの結果は、レビューのために PR にコメントとして追加され、電子メールで送信される場合があります。
• ステージング: 合格した検証とビルドの後に、変更した記事は、レビューするために自動的にステージング環境にデプロイされます。 PR コメントにプレビュー URL が表示されます。
• 自動マージ:PR は、検証テストと特定の基準に合格した場合、自動的にマージされることがあります。 この場合、ほかに何も実行する必要はありません。

フィードバックの確認と対処

すべての PR 処理が完了したら、結果 (PR コメント、ビルド結果など) を確認する必要があります。 マージのためにサインオフする前に、さらに変更を加える必要があるかどうかを判断します。 次のいずれかの理由により、コンテンツの変更が必要になる場合があります。

• 校閲者からの PR コメント。 PR 校閲者が PR をレビューした場合、マージ前に解決すべき未解決の問題や質問がある場合は、コメントを介してフィードバックを提供できます。
• ピア レビュー担当者からのフィードバック。
• レンダリングの問題による書式設定の修正。
• 検証エラーまたは警告。
• マージの競合。

変更を加える必要がある場合は、PR で直接コンテンツを編集するか、VS Code に戻って変更を加えることができます。 完了したら、作業ブランチに変更をコミットします。 PR は、変更内容に合わせて自動的に更新されます。

同じ作業ブランチにコミットを追加するたびに、コミットが PR に自動的に追加されます。 コミットのたびに、発行システムは検証を再実行し、プロセスを自動的に確認します。

サインオフとコメントの自動化

すべてのフィードバックと検証エラーに対処し、変更をマージする準備ができたら、新しいコメント #sign-offを作成して PR にサインオフします。 変更をマージするには、 #sign-off コメントを入力する必要があります。 すべてのレビューと検証チェックが成功した場合でも、このコメントを使用して、変更をマージする準備ができていることを PR レビュー担当者とリポジトリ管理者に伝える必要があります。

校閲者が PR が問題なくサインオフされていると判断すると、変更は既定のブランチにマージされ、PR は閉じられます。

コメントの自動化により、リポジトリに書き込みアクセス許可がないユーザーは、適切なラベルを PR に割り当てることで、書き込みレベルのアクションを完了できます。 コメント オートメーションが実装されているリポジトリで作業している場合は、次のテーブルに一覧表示されているハッシュタグ コメントを使用して、ラベルを割り当てたり、ラベルを変更したり、PR を終了したりします。 Microsoft の作成者は、記事に変更が提案されるたびに、レビューとサインオフのために電子メールで通知されます。

ハッシュタグ コメント	できること
#sign-off	ready-to-merge ラベルを自動的に割り当てて、リポジトリのレビュー担当者に、レビュー/マージの準備が PR にできていることを通知します。 リストされている作成者では "ない" 場合、#sign-off コメントを使用してパブリックリポジトリの PR をサインオフしようとすると、PR が更新されて、ラベルを割り当てることができるのは作成者のみであることが示されます。
#hold-off	気が変わったか、間違えた場合に、ready-to-merge ラベルを削除します。 これにより、プライベート リポジトリ内で do-not-merge ラベルが割り当てられます。
#please-close	変更をマージしないと決めた場合に、PR を閉じます。
#please-open	閉じた PR または問題を再度開きます。

公開

次のスケジュールされた発行実行に変更を含める前に、PR レビュー担当者によって PR をマージする必要があります。 通常、PR のレビューとマージは申請順に行われます。

投稿が承認され、マージされると、発行プロセスに追加されます。 投稿するリポジトリを管理しているチームに応じて、発行の頻度が異なる可能性がありますが、通常、平日は毎日 1 回以上発行されます。 発行後、記事がオンライン表示されるまで最大 45 分かかります。

変更が発行されると、Microsoft Learn で一般公開され、他のユーザーがそこから学習できるようになります。

次のステップ

これで完了です。 これで、投稿は Microsoft Learn コンテンツになりました。