今日の英語表現 6/30 · ステップ: Issue を開く 例文はすべてこの記事のために作成したものです。実際のレポジトリのコメントをそのまま持ってきたものではなく、フィールド名は例示です。
目次
概要
| 表現 | Let me know if I'm missing something. |
| 意味 | 見落としている点があれば教えてください。 |
| 使われる場面 | Issue の本文の末尾、レビューコメント、設計に関する質問 |
| 丁寧さ | 普通。謙虚ですが、自分を卑下しすぎません |
1. 意味とニュアンス
miss は「見落とす、気づかない」という意味です。I'm missing something は「自分は(今)何かを見落としている」という意味になり、頭に Let me know if をつけると「もしそうであれば教えてほしい」となります。
この表現は、 主張と謙虚さを同時に伝えます。 前の文では「このコードは nil のチェックをしていないようです」のように自分の判断をはっきりと述べ、最後にこの1行を添えることで「それでも自分が知らないコンテキストがあるかもしれない」と認めます。レポジトリの歴史や他の利用箇所をすべて把握できない外部コントリビューターにとって特に適しています。
進行形(I'm missing)を使う理由は、「今この会話の中で見落としていること」を指すためです。過去形の I missed something は「さっき何かを見落とした」という特定の出来事に近くなります。どちらも使われますが、Issue の末尾における慣用的な締めくくりとしては進行形が使われます。
注意すべき点もあります。根拠もなくこの言葉だけを付け加えると、「確認もせずに質問している」ように見えてしまいます。前で何を検証したのかを明らかにした上で添えると効果的です。
2. 例文
状況 1: Issue 本文の最後の行
The
retentionPolicyfield is documented as optional, but the webhook rejects the resource when it's empty. It looks like the default is never applied. Let me know if I'm missing something.
状況 2: レビューコメント
This branch seems unreachable because
spec.pausedis already checked above. Am I missing something?
Am I missing something? は同じ意味の短い疑問文の形です。レビューで「なぜこのコードが必要なのかわからない」と言いたいときに柔らかく表現するためによく使われます。
状況 3: ドキュメントを読んで質問するとき
I followed the upgrade guide, but step 3 refers to a ConfigMap that doesn't exist in the default install. Happy to fix the docs if this is a mistake, but let me know if I'm missing something.
3. 似た表現との違い
- Correct me if I'm wrong, but ... 文の冒頭に置きます。のちに続く主張が間違っているかもしれないとあらかじめ断る表現であるため、少し自分の主張が強く感じられることもあります。
- Am I missing something? 同じ意味の疑問文の形です。短いため、レビューのインラインコメントに適しています。ただし、抑揚のないテキストとして読まれると少し皮肉っぽく感じられることがあるため、事前に根拠を記述しておきます。
- Is there a reason ...? 「〜という理由がありますか?」と、意図を直接尋ねます。Is there a reason we don't cache this? のように使います。
4. 韓国人がよく犯す間違い
- Sorry if I'm wrong, but ... すべての質問の冒頭に謝罪を添えると自信がないように見え、メンテナーが毎回「大丈夫です」と答える手間が生じます。
- 修正した文: This looks like a bug to me. Let me know if I'm missing something.
- Please tell me if I miss something. 現在形の miss を使うと習慣を表すことになってしまい、不自然です。
- 修正した文: Let me know if I'm missing something.
- Maybe I don't understand well, but ... 自分の理解力をあらかじめ低く見積もる文は、Issue の信頼性を下げてしまいます。
- 修正した文: If I'm reading this correctly, ...
5. 1行練習
次の韓国語の文を英語に翻訳してください。
このリトライループはエラーを無視しているようです。私が見落としている点があれば教えてください。
模範解答
This retry loop seems to swallow the error. Let me know if I'm missing something.
swallow the error は「エラーを飲み込む」、すなわちエラーをキャッチしながら何もしないことを指す開発者の表現です。ignore the error と書いても意味は通じます。
Titi のひと言 根拠は明確に、締めくくりはオープンな質問にすることで、反論ではなく対話が始まります。
参考
- Merriam-Webster, 「miss」: https://www.merriam-webster.com/dictionary/miss
- Google Engineering Practices, How to write code review comments: https://google.github.io/eng-practices/review/reviewer/comments.html