やわらかく伝える3つのコツ
人ではなくコードについて書く。 Googleのレビューガイドは、相手を傷つけかねない指摘ほど「コードについてコメントし、開発者についてはコメントしない」ことを勧めています(Googleのレビューガイド )。「You forgot ...」より「This is missing ...」。
理由を添える。 同じガイドは、なぜその指摘をするのかを説明すると相手が意図を理解しやすい、としています(Googleのレビューガイド )。
重要度を示す。 「nit:」(細かい指摘)、「optional:」(任意)、「FYI:」(参考)などのラベルで、直すべきかどうかを明確にします。
提案するときの例文
英語 意味
What do you think about extracting this into a helper? これをヘルパーに切り出すのはどうでしょう?
Could we use a map here instead of a loop? ここはループの代わりにmapを使えませんか?
Consider adding a test for the empty case. 空の場合のテストを追加することを検討してください。
nit: I'd rename this to isEnabled. nit: isEnabled という名前のほうがいいと思います。
Optional: we could cache this result. 任意ですが、この結果はキャッシュできます。
質問するときの例文
英語 意味
Just curious, why did you choose this approach? 純粋な質問ですが、この方法を選んだ理由は?
Is this check still needed? このチェックはまだ必要ですか?
What happens if user is null here? ここで user が null だとどうなりますか?
Am I missing something, or is this unused? 私の見落としでなければ、これは使われていない?
必ず直してほしいときの例文
英語 意味
This will break when the list is empty. Could you add a guard? リストが空のときに壊れます。ガードを追加してもらえますか?
We shouldn't log the password here, even in debug mode. デバッグモードでも、ここでパスワードをログに出すべきではありません。
Blocking: this changes the public API, so we need a migration plan. 要対応:公開APIが変わるので、移行計画が必要です。
褒めるときの例文
英語 意味
Nice catch! よく気づきましたね!
This is much cleaner, thanks! ずっと読みやすくなりました、ありがとう!
Great test coverage. テストがよく網羅されていますね。
コメントに返信するときの例文
英語 意味
Good point, fixed. ごもっともです、直しました。
Done in a1b2c3d. a1b2c3dで対応しました。
I'd prefer to keep it as is, because ... …なので、このままにしたいです。
Let's discuss this in a follow-up. これは別途話しましょう。
よく使う略語はLGTM (承認)、nit (細かい指摘)、PTAL(もう一度見てください)、SGTM(いいですね)、IMO (私の意見では)です。
Devlingoで開発現場の英語を1日10フレーズ
コードレビューやプルリクエストの英語は、Gambit StudioのDevlingo(English for Devs)の「Code Review」「Pull Requests」カテゴリで学べます。全12カテゴリ・3,600以上のフレーズを1日10個ずつ、使う場面と発音ガイド、例文つきで。画面表示は英語などで、日本語には対応していません。
English for Devs - Devlingo 無料でダウンロード(App内課金あり) · iOS 17.0 以降 アプリのページ →
リモートの開発現場で毎日使う英語フレーズを3,600以上、12カテゴリに収録:デイリースタンドアップ、コードレビュー、Slack、ビジネスメール、ミーティング、技術的な議論、プルリクエスト、バグ報告、ペアプログラミング、面接、雑談、ドキュメント。
1日10フレーズ。各フレーズに実際の使用場面、発音ガイド、実用的な例がつきます。
ホーム画面ウィジェットで、アプリを開かなくても今日のフレーズを確認できます。
観光英語やレストランの会話はなし。中級レベルの英語を仕事で使える英語にしたい開発者向けです。
App Storeの対応言語は英語・フランス語・ドイツ語・イタリア語・ポルトガル語・スペイン語で、画面は日本語表示に対応していません。
App Storeでダウンロード