今日の英語表現 10/30 · ステップ: PRの説明 例文はすべてこの記事のために作成したものです。実際のレポジトリのPRをそのまま持ってきたものではなく、番号は例です。
目次
一目でわかる要約
| 表現 | I'll address this in a follow-up (PR). |
| 意味 | この部分は後続のPRで対応します。 |
| 使う場面 | レビューの返信、PRの説明における残作業の処理など |
| 丁寧さ | 普通。理由とともに伝えると信頼感が増します |
1. 意味とニュアンス
「follow-up」は「後続の作業、フォローアップ」という意味の名詞および形容詞です。「a follow-up PR」は「後続のPR」、「a follow-up issue」は「後続のイシュー」となります。短く「in a follow-up」とだけ書いてもPRのことを指していると理解されます。「address」はここで「（問題など）に対処する、処理する」という意味になります。
この表現には「拒絶ではなく順序の問題である」というニュアンスが含まれます。第9回の「out of scope」とペアになります。スコープ外であると線引きし、その代わりにいつどこで処理するのかをこの表現で約束します。
注意すべき点があります。レビュアーはこの言葉を警戒することもあります。Googleのコードレビューガイドラインでは、レビュアーが「後で整理する」という約束を受け入れるのではなく、通常はマージ前の整理を求めるよう推奨しています。後続の整理が実際には行われないことが多いためです。そのため、この表現を使うときは 信頼の根拠を一緒に提示します。後続のイシュー番号を載せたり、今回のPRを小さく保つべき理由を書いたり、後続のPRをすぐにオープンにしたりする方法があります。レビュアーから「今回のPRで対応してほしい」と改めて言われた場合は、そのリクエストに従う方が早いことが多いです。
動詞として使う場合はスペースで区切ります。「後続の対応をする」は「follow up (on something)」です。「I'm going to follow up on this next week」のように使います。
2. 例文
状況1: レビューへの返信
Agreed that the error messages could be clearer. I'd like to keep this PR small, so I'll address it in a follow-up. Opened #3101 to track it.
状況2: PRの説明における残作業の記載
Follow-ups:
- Add e2e coverage for the IPv6 path (#3102)
- Update the user guide once the API is finalized
残作業をPRの説明にリストとして記載しておくと、レビュアーが安心して承認できます。
状況3: 後続のPRを作成し、元のPRに通知する場合
Follow-up PR is up: #3110. It addresses the remaining comments from this review.
「is up」は「公開されている、上がっている」という意味の口語表現です。
3. 似た表現との違い
- Let's do this as a separate PR. 後続の作業か別の作業かを問わない表現です。前後の順序が重要ではないときに使います。
- I'll follow up on this. 動詞の形です。PRではなく、質問や調査を後日引き続いて行うという意味でも使います。
- TODO(follow-up). コードのコメントに残す目印です。実際に追跡できるようにするため、イシュー番号と一緒に残す必要があります。
4. 韓国人がよく犯すミス
- I will follow-up this in next PR. 動詞にハイフンが使われており、冠詞「a」と前置詞「on」が抜けています。
- 修正した文: I'll follow up on this in a separate PR.
- I will fix it next time. 「next time」がいつを指すか分からないため、約束として伝わりません。
- 修正した文: I'll address this in a follow-up PR. Tracking it in #3101.
- This will be done later. 受動態のため、誰がやるのかが抜けています。
- 修正した文: I'll take care of this in a follow-up.
5. 1行練習
次の韓国語の文をレビューの返信用に書き換えてください。
テストの追加は後続のPRで行います。今回のPRにはバグ修正だけを含めたいです。
模範解答
I'll add the tests in a follow-up PR. I'd like to keep this one focused on the bug fix.
「this one」は「this PR」の繰り返しを避けるための代名詞です。「keep ... focused on」は「〜に集中させる」という意味です。
Titiの一言 「後で」という言葉は、番号が紐づけられている場合にのみ信頼を得ることができます。
参考
- Google Engineering Practices, Handling pushback in code reviews: https://google.github.io/eng-practices/review/reviewer/pushback.html
- Merriam-Webster, 「follow-up」: https://www.merriam-webster.com/dictionary/follow-up