今日英语表达 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 意为“后续 issue”。即使简写为 in a follow-up,大家也能听懂是指 PR。这里的 address 意为“处理、解决(问题)”。
这个表达包含了“这不是拒绝,而是处理顺序的问题”的意味。它与第 9 篇的 out of scope 是一对。先划清范围说不在本次范围内,然后用这个表达承诺何时何地去处理。
但有一点需要注意,评审人员有时会对这句话保持警惕。Google 的代码审查指南建议,比起接受“以后再整理”的承诺,评审人员通常最好要求在合并前完成整理,因为后续整理往往不了了之。所以在说这句话时,需要给出 让人信服的依据。比如关联后续的 issue 编号、写明需要保持当前 PR 精简的原因、或者直接把后续的 PR 创建好。如果评审人员再次要求“请在本次 PR 中完成”,通常听从他们的要求会更快。
当用作动词时要分开写。“采取后续行动”是 follow up (on something)。比如写作 I'll 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). 留在代码注释中的标记。必须连同 issue 编号一起留下来才能真正被追踪。
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. 一行练习
请将以下韩语句子改写为代码审查的回复。
添加测试将在后续 PR 中进行。我希望这个 PR 只包含 Bug 修复。
参考答案
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