TT Lab
博客

한국어 English 日本語 中文

开始
博客

博客

Would you be open to ...?: 发送 PR 前征求方向的礼貌建议

今日英语表达 5/30 · 阶段:开启 Issue。 例句均为本文特意创作。并非直接搬运实际仓库中的评论,功能名称仅为示例。

目录

一目了然

表达 Would you be open to + 动名词/名词?
含义 您是否有兴趣接受(考虑)……?
使用场景 功能提议 Issue、设计讨论、开启 PR 前的提问
礼貌程度 较高。但不过分,非常适合工作交流

1. 含义与语感

open to 的意思是“对……持开放态度”,即“乐意考虑”。词典中将 open to suggestions 解释为“有意愿考虑新的想法”。在此基础上加上 Would you be open to,就成了一个礼貌的提问:“您是否有意愿考虑……?”

该表达在开源领域非常实用的原因是 把决定权交给了对方 。如果外部贡献者直接发送包含大量重构或新选项的 PR,维护者就会面临不得不拒绝对方已付出努力的压力。如果先用 Would you be open to ...? 询问,维护者就可以毫无压力地回答“好”、“换成别的方式更好”或“超出范围”。实际上,也有很多仓库要求先开启 Issue 并达成共识后再发送 PR。

注意语法。由于 to 是介词,后面应接 动名词(-ing)或名词。不是 Would you be open to add ...,而是 Would you be open to adding ...。

2. 例句

情况 1:功能提议 Issue

Would you be open to adding a --dry-run flag to the restore command? I'd be happy to send a PR if this sounds reasonable.

如果在提议后面加上“如果觉得合理,我很乐意发个 PR”,就能明确表明这不是在把工作甩给别人。

情况 2:提出设计替代方案时

Would you be open to a small refactor here? Splitting reconcile() into two functions would make the new check easier to test.

情况 3:在 Code Review 期间建议扩大范围时

Would you be open to handling the IPv6 case in this PR as well, or would you prefer a separate one?

加上 or would you prefer ...? 给出选项会显得更加温和。

3. 相似表达与区别

4. 韩国人常犯的错误

5. 一行练习

请将以下韩语句子翻译成英语。

在这条错误消息中加入解决方法链接怎么样?如果可以的话,我来发一个 PR。

参考答案

Would you be open to adding a link to the troubleshooting guide in this error message? If so, I'm happy to send a PR.

If so 是对“如果是这样的话(如果你觉得行)”的简短翻译。将解决方法指南称为 troubleshooting guide 在文档术语中更加自然。

Titi 小贴士。 在动手写代码之前先用一句话询问方向,就可以省去一个被拒绝的 PR。

参考

登录后即可点赞

评论

还没有评论。

登录后即可发表评论