TT Lab
ブログ

한국어 English 日本語 中文

はじめる
ブログ

ブログ

This is out of scope for this PR: 範囲を守りつつ丁寧に対象外であることを伝える

今日の英語表現 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.go look unrelated. Could you move them to a separate PR? They're out of scope here and make the diff harder to review.

3. 似た表現との違い

4. 韓国人がやりがちな間違い

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の一言。 「やらない」ではなく「ここではやらない、あっちでやる」と言えば、一線を画しても関係性はそのまま保てます。

参考

ログインするといいねできます

コメント

まだコメントはありません。

ログインするとコメントできます