今日英语表达 13/30 · 阶段:接收并回复评审。 例句均为本文创作。并非实际仓库中的评论摘录,提交(commit)和文件名均为示例。
目录
概览
| 表达 | PTAL / Could you take another look? |
| 含义 | (我已经修改过了)能再看一次吗? |
| 使用场景 | 反映评审意见后的 PR 评论、Slack 上的评审请求 |
| 礼貌程度 | PTAL 简短且中立,Could you ...? 较为礼貌 |
1. 含义与语境
take a look 是“看一看”,take another look 则是“再看一看”。PTAL 是 please take a look 或 please take another look 的缩写,在评审文化中广泛使用。Kubernetes 贡献指南指导大家在反映评审反馈后留下诸如“please take another look”(PTAL)的评论。
这个表达的作用是 把球传回给评审人员。由于评审人员同时在看多个 PR,仅凭你提交了修改后的 commit 这一事实,他们可能并不知道轮到他们再次查看了。PTAL 评论在发送通知的同时,也传达了“现在轮到你了”的信息。
PTAL 因为是缩写,所以简短高效,但如果是初次合作的评审人员,或是时隔很久再次请人帮忙,最好使用 Could you take another look when you have a chance? 这样完整客气的句式。when you have a chance 或 when you get a chance 意为“有空的时候”,可以消除催促的感觉。
最重要的是 同时写明修改了什么内容。如果只留下 PTAL 一个单词,评审人员就得自己去寻找该从哪里开始重新查看。
2. 例句
情况 1:反映评审意见后的 PR 评论
Thanks for the review! I've addressed all comments: renamed the field, added the nil check, and moved the test to
webhook_test.go. PTAL.
情况 2:客气地请求特定评审人员
Could you take another look when you get a chance? The main change since your last review is the new retry logic in
client.go.
since your last review 意为“自上次评审以来”,它缩小了需要重新查看的范围。
情况 3:Slack 上的评审请求频道
Hi! I updated the backup docs PR based on last week's feedback. PTAL if you have a moment: (PR link)
3. 相似表达与区别
- Could you take a look? 初次请求评审时使用。如果没有 another,则表示“请看一下(首次)”。
- Ready for another round. 意为“准备好进入下一轮评审了”,在多次来回评审的情况下使用。
- Gentle reminder. 请求评审后迟迟没有回复时使用的话。与第 24 篇中的 friendly ping 场景相似。
4. 韩国人常犯的错误
- Please review again ASAP. ASAP 带有强烈的催促意味,外部贡献者对维护者说这话会显得很不礼貌。
- 修改后的句子:Could you take another look when you get a chance?
- I fixed. Please check. 缺少了 fix 的宾语,并且不知道要对方检查什么。
- 修改后的句子:I've fixed the issues you pointed out. PTAL.
- Please kindly take a look again at your convenience if possible. kindly、at your convenience、if possible 堆砌在一起,显得过于冗长。
- 修改后的句子:Could you take another look when you have a chance?
5. 一行练习
请将以下韩语句子改写为 PR 评论。
正如您所说,我修改了函数名并添加了测试。有空的话能再看一次吗?
参考答案
As you suggested, I renamed the function and added tests. Could you take another look when you have a chance?
As you suggested 是对“正如您所说”的自然翻译。它表明听取了评审人员的建议,同时也传达了谢意。
Titi 小贴士。 在 PTAL 前面加上一行“修改了什么内容”,评审人员就能更快地回来查看。
参考资料
- Kubernetes 贡献指南,Pull Request Process(PTAL): https://github.com/kubernetes/community/blob/master/contributors/guide/pull-requests.md
- Merriam-Webster, “look”(take a look): https://www.merriam-webster.com/dictionary/look