プルリクエスト
まずこれだけ
プルリクエストは、作った変更を「これで取り込んでよいですか」と見てもらうための場です。PR(ピーアール)と略されることもあります。ブランチ で作業した内容を、いきなり本流へ入れるのではなく、差分を見せ、説明し、コメントを受け、必要なら直してから取り込む流れを作ります。完成報告だけでなく、途中相談の場所としても使えます。
どこで見かけるか
GitHub(ギットハブ) の「Pull requests(プルリクエスト)」タブで見かけます。変更されたファイル、追加・削除された行、関連する Issue(イシュー)、実行されたチェック、レビューコメント、最終的に取り込むボタンがまとまっています。「レビューお願いします」「PRを出しました」「マージします」という会話は、この確認の流れを指しています。
具体例
研究会サイトの用語説明を直した場合、プルリクエストには「どの用語を直したか」「読者に合わせて何を増やしたか」「確認方法は何か」を書きます。確認する人は、変更された行を見ながら「ここは分かりにくい」「このリンクはよい」「公開してよさそう」とコメントできます。修正が必要なら同じブランチに追加で コミット し、PR上で再確認します。
つまずきやすいところ
プルリクエストは厳しい審査会ではありません。変更を見える形にして、早めに相談するための道具です。ただし、1つのPRに無関係な変更を詰め込みすぎると、確認する人が困ります。目的ごとに分け、説明を書き、チェック結果を見ると進めやすくなります。秘密情報が含まれていないか、公開してよい内容かも、PRの段階で確認します。
研究会では
AI(エーアイ)と一緒に作った変更でも、そのまま公開せず、コミット を確認してからプルリクエストで見てもらう流れが安心です。関連する相談は Issue(イシュー) に残せます。PRは「AIが作ったものを人が責任を持って確認する」ための場所として、とても相性がよいです。
