今日の英語表現 9/30 · ステージ: PR説明 例文はすべてこの記事のために作成したものです。実際ののリポジトリのPRをそのまま持ってきたものではなく、機能名は例です。
目次
一目でわかるまとめ
| 表現 | This is out of scope for this PR. |
| 意味 | それは今回のPRの範囲外です。 |
| 使う場面 | PR説明の範囲に関する記述、レビューへの返信、設計の議論 |
| 丁寧さ | 中立。後ろに代替案を添えると丁寧になります |
1. 意味とニュアンス
scopeとは仕事や議論が扱う「範囲」のことです。in scope は範囲内、out of scope は範囲外です。This is out of scope for this PR は「その提案が間違っている」ではなく「今回のPRで扱うと決めた範囲ではない」という意味です。そのため、相手の提案を否定することなくPRを小さく保つことができます。
PRを小さく保つことはオープンソースにおいて重要な原則です。レビュアーが一度に理解できる量には限界があり、範囲が広がるほどマージが遅れます。ただし、この言葉だけで単体で使うとややそっけなく聞こえます。 代替案を一緒に提示するのが慣例です。「別途issueを立てる」、「後続のPRで行う」のように、その作業が放置されないことを示します。
レビュアーもこの表現を使います。コントリビューターがPRに関係のない変更を混ぜたとき、「この部分は範囲外なので除外してください」と言う場合です。このときは Could you drop this change? It's out of scope for this PR. のように要求と一緒に使います。
2. 例文
状況1: PR説明にあらかじめ範囲を明記する場合
Out of scope: This PR doesn't change the CLI output format. I'll open a separate issue for that.
PR説明に In scope / Out of scope をあらかじめ書いておくと、レビューで同じ質問が繰り返されなくなります。
状況2: レビュアーの提案に返信する場合
Good idea, but I think it's out of scope for this PR. I've opened #2345 to track it so we don't lose it.
so we don't lose it は「忘れないようにするため」という意味で、提案を尊重しているというサインになります。
状況3: レビュアーが範囲を狭めるよう求める場合
The formatting changes in
utils.golook unrelated. Could you move them to a separate PR? They're out of scope here and make the diff harder to review.
3. 似た表現との違い
- I'd rather keep this PR focused. 「このPRは1つのことに集中させたい」という意味で、範囲外であることをより柔らかく言い換えた表現です。
- Beyond the scope of this PR. 同じ意味で、少しよりフォーマルです。ドキュメントや設計書などでよく使われます。
- Let's handle that separately. 範囲について言及せず、すぐに解決策を提示します。短く協力的です。
4. 韓国人がやりがちな間違い
- It is not my job. 「それは私の仕事ではありません」と聞こえ、失礼になる可能性があります。範囲の問題として言い換えます。
- 修正した文: That's out of scope for this PR, but I'm happy to look at it in a follow-up.
- This is out of range of this PR. range は数値や値の範囲に使います。作業の範囲は scope です。
- 修正した文: This is out of scope for this PR.
- I can't do it in this PR. 能力の問題のように聞こえます。意図的に分けているのだということを明らかにします。
- 修正した文: I'd prefer to do it in a separate PR to keep this one small.
5. 1行練習
次の韓国語の文をレビューへの返信として書き換えてください。
良い指摘ですが、今回のPRの範囲外だと思います。別途issueを立てておきました。
模範解答
Good point, but I think this is out of scope for this PR. I've opened a separate issue to track it.
to track it は「追跡するために」、つまり忘れずに管理するためにという意味です。オープンソースでissueを開く目的を伝える際によく使われます。
Titiの一言。 「やらない」ではなく「ここではやらない、あっちでやる」と言えば、一線を画しても関係性はそのまま保てます。
参考
- Merriam-Webster, 「scope」: https://www.merriam-webster.com/dictionary/scope
- Google Engineering Practices, Small CLs: https://google.github.io/eng-practices/review/developer/small-cls.html