This is out of scope for this PR: 恪守范围并温和地划清界限

今日英语表达 9/30 · 阶段：PR 说明。 所有例句均为本文特意编写。并非搬运自实际仓库的 PR，功能名称仅为示例。

目录

• 一目了然
• 1. 含义与语境
• 2. 例句
• 3. 相似表达与区别
• 4. 韩国人常犯的错误
• 5. 一行练习
• 参考答案
• 参考

一目了然

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. 相似表达与区别

• I'd rather keep this PR focused. 意为“我希望这个 PR 专注于一件事”，是将“超出范围”这句话说得更委婉的表达。
• 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. 一行练习

请将以下韩语句子改写为评审回复。

意见很好，但我觉得这超出了本次 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