エンジニア英語

プルリクエストの英語:タイトル・説明文・依頼の書き方

簡単な答え

プルリクエストの英語は、タイトルを「Add CSV export to reports」のような動詞の原形で始め、説明文に「何を・なぜ・どう確かめたか」を書くのが基本です。「プルリクエストを出す」は open a pull request、「レビューを頼む」は request a review。DevlingoはGambit Studioのアプリで、PRの英語を学べます。

更新日 3 分で読めますGambit Studio

インストールなしで使う →ブラウザで無料、登録不要

プルリクエストでよく使う英語

日本語英語
プルリクエストを出すopen a pull request / create a PR / submit a PR
レビューを依頼するrequest a review / ask someone to review
承認するapprove
修正を求めるrequest changes
指摘に対応するaddress the comments / feedback
コンフリクトを解消するresolve conflicts
マージするmerge
クローズするclose
下書きのPRdraft pull request

GitHubのレビューでは、レビュアーがComment、Approve(承認)、Request changes(変更をリクエスト)のどれかを選びます(GitHub Docs)。

タイトルと説明文の書き方

タイトルはコミットメッセージと同じく、動詞の原形で始めます。Googleのレビューガイドも、変更の説明の1行目は「何をするか」を具体的に要約した、命令文の完全な文にするよう勧め、本文には問題の背景や、その方法を選んだ理由を書くとしています(Googleのレビューガイド)。

## Summary
Add CSV export to the reports page.

## Why
Customers asked to open reports in Excel.

## Changes
- Add ExportButton component
- Add /reports/export endpoint

## How to test
1. Open Reports
2. Click "Export CSV"

Closes #123

そのまま使える例文

英語意味
This PR adds CSV export to the reports page.このPRはレポート画面にCSV出力を追加します。
This is a follow-up to #120.#120の続きの対応です。
Could you take a look when you have a moment?手が空いたときに見てもらえますか?
I'd appreciate a review from someone familiar with the billing code.請求まわりのコードに詳しい方のレビューをお願いしたいです。
Addressed all comments. PTAL.指摘はすべて対応しました。もう一度見てください。
Rebased on main and resolved the conflicts.mainにリベースして、コンフリクトを解消しました。
This is out of scope for this PR. I'll open a follow-up.このPRの範囲外なので、別のPRで対応します。
Merging now. Thanks for the reviews!マージします。レビューありがとうございました!

「プルリクエスト」の意味と語源

プルリクエストは「自分の変更を取り込んで(pull して)ください、という依頼(request)」から来た言葉です。GitHubの説明では、コードの変更をプロジェクトにマージするための提案で、マージ前に話し合い、確認できる仕組みです(GitHub Docs)。GitLabでは同じものをmerge request(MR)と呼びます。

Devlingoで開発現場の英語を1日10フレーズ

コードレビューやプルリクエストの英語は、Gambit StudioのDevlingo(English for Devs)の「Code Review」「Pull Requests」カテゴリで学べます。全12カテゴリ・3,600以上のフレーズを1日10個ずつ、使う場面と発音ガイド、例文つきで。画面表示は英語などで、日本語には対応していません。

出典

  1. GitHub Docs「プル リクエスト レビューについて」
  2. Google Engineering Practices「Writing good CL descriptions」
  3. GitHub Docs「プル リクエストについて」(ドラフト プル リクエスト)

よくある質問

よく聞かれる質問に、出典つきで答えます。

「プルリクエストを出す」は英語で?
open a pull request が一般的です。create a PR、submit a PR とも言います。
プルリクエストは日本語で何と言う?
日本語でもそのまま「プルリクエスト」「プルリク」「PR」と呼ぶのが普通です。意味は「変更を取り込むための依頼・提案」です。
PRとMRの違いは?
GitHubのpull request(PR)とGitLabのmerge request(MR)は、呼び方が違うだけでほぼ同じ仕組みです。
PRの説明文には何を書けばいい?
何を変えたか(Summary)、なぜ変えたか(Why)、どう確かめたか(How to test)の3つが基本です。

続けて読む

同じアプリのガイドをもっと。手順と出典つき。

Devlingo無料 · iOS 17.0+
インストールなしで使う入手