今日の英語表現 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の間隔を1週間としています。依頼したレビュアーから1週間返事がない場合、pingをしてもよいとしており、急ぎのパッチについては理由を説明した上で数日おきに行えるとしています。
- パス。 Kubernetesのコントリビューションガイドでは、まずPRに担当者がいるか確認し、PRのコメントで担当者にいつ頃レビューできるか尋ねるよう案内しています。それでも返事がない場合はSlackやメール、チームへのメンションを使い、最後にSlackのレビューリクエストチャンネルにPRのリンクを貼るよう求めています。
- 内容。 CIが失敗している場合はまず直します。そして現在の状態（すべての指摘を反映済み、CI通過）を一行で知らせ、レビュアーが何をすべきかを示します。
リポジトリごとにルールが異なるため、コントリビューション（CONTRIBUTING）文書をまず確認します。
2. 例文
状況1: 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のレビューリクエストチャンネル
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. 1単語だけで使う方法です。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.
- 1日に 何度も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の一言。 1週間待ち、状態を一行で知らせ、負担を和らげる言葉を添える。それが親切なpingです。
参考
- LLVM Code-Review Policy and Practices(ping): https://llvm.org/docs/CodeReview.html
- Kubernetesコントリビューションガイド、Pull Request Process（レビューがない場合）: https://github.com/kubernetes/community/blob/master/contributors/guide/pull-requests.md
- Merriam-Webster, 「ping」: https://www.merriam-webster.com/dictionary/ping