今日英语表达 24/30 · 阶段:会议与聊天。 所有例句均为本文特意创作。并非搬运实际仓库中的评论,时间和频道名称均为示例。
目录
一目了然
| 表达 | Friendly ping. / Gentle ping on this. |
| 含义 | (毫无负担地)再次提醒一下。 |
| 使用场景 | 无回复的 PR、Issue 评论,Slack,邮件列表 |
| 礼貌程度 | 温和。减轻了催促的感觉 |
1. 含义与语境
ping 是网络中确认对方是否存活的命令名称。由此引申开来,它被广泛用作动词和名词,意为“简短地联系(某人)、发送信号”。I'll ping you later 意思是“我待会儿联系你”。加上 friendly 或 gentle 的 Friendly ping 意思是“并非想要催促,只是担心你可能漏掉了,所以再次提醒”。
开源维护者大多很忙,通知堆积导致漏掉 PR 的情况屡见不鲜。因此,以适当的间隔再次提醒并非失礼,而是符合预期的行为。关键在于 间隔和 内容。
- 间隔。 LLVM 的代码审查文档认为,对于不紧急的补丁,礼貌的 ping 间隔为一周。如果请求的审阅者一周内没有回复,可以进行 ping;如果是紧急补丁,说明原因后可以缩短至几天一次。
- 路径。 Kubernetes 贡献指南指导大家先确认 PR 是否有负责人,并通过 PR 评论询问负责人大概什么时候可以进行 review。如果依然没有回复,可以使用 Slack、邮件或团队艾特(mention),最后在 Slack 的 review 请求频道中发布 PR 链接。
- 内容。 如果 CI 报错,请先修复。然后用一句话说明当前状态(已采纳所有意见、CI 已通过),以便审阅者清楚需要做什么。
每个仓库的规则各不相同,请先查看 CONTRIBUTING 文档。
2. 例句
情况 1:超过一周没有回复的 PR
Friendly ping on this one. All comments are addressed and CI is green. Let me know if there's anything else you'd like me to change.
CI is green 是开发者常用的表达,意思是“CI 全部通过了”。
情况 2:询问负责人预计时间
Gentle ping. Do you think you'll have time to review this before the next release? No rush if not, just want to plan the follow-up work.
No rush if not 意思是“如果不行的话也不用着急”,减轻了对方的负担。
情况 3:Slack 的 review 请求频道
Hi all, friendly ping for a review on this docs PR for the backup plugin. It's a small change (about 20 lines): (PR link)
告知变更的大小可以让审阅者判断这是否是一件能在短时间内处理完的工作。
3. 相似表达与区别
- Ping. 只用一个单词的方式。LLVM 文档也将 ping 解释为“包含 Ping 一词的评论”。虽然简短但缺乏上下文,对于初次见面的审阅者来说,最好在 friendly ping 后面附上一行状态说明。
- Just bumping this. bump 意思是“把(帖子)再次顶上去”。在论坛或邮件列表中经常使用。
- Any updates on this? 这是一个要求对方给出答复的提问,语气稍微更直接一些。如果已经等待了很长时间,用这个是可以的。
4. 韩国人常犯的错误
- Why nobody reviews my PR? 语法不仅错了,听起来还像是在抱怨。
- 修改后的句子:Friendly ping. Is there anything I can do to make this easier to review?
- Please review ASAP. It is urgent. 如果没有说明为什么紧急,这就只是单纯的催促。
- 修改后的句子:Gentle ping. This fixes a crash on upgrade, so it would be great to get it into the next patch release.
- 一天内 多次 ping。 这会造成通知疲劳,反而会拖慢进度。请遵守间隔时间。
5. 一行练习
请将以下韩语句子改写为 PR 评论。
再次提醒一下。你指出的地方我都修改了,测试也通过了。有空的时候请看一看。
参考答案
Friendly ping. I've addressed all the comments and the tests are passing. Could you take a look when you have time?
最后一句的结构与第 13 篇中的 Could you take another look? 相同。在 ping 后面要明确写出审阅者需要做的事情。
Titi 小贴士。 等待一周,用一句话告知状态,并附上减轻对方负担的话。这才是友好的 ping。
参考资料
- LLVM Code-Review Policy and Practices(ping): https://llvm.org/docs/CodeReview.html
- Kubernetes 贡献指南,Pull Request Process(无人 review 时): https://github.com/kubernetes/community/blob/master/contributors/guide/pull-requests.md
- Merriam-Webster, 「ping」: https://www.merriam-webster.com/dictionary/ping