Giving Feedback in Code Review — The whole team
Situation
場面- Where
- On a pull request
- Who
- You (reviewer) and a the whole team
- Goal
- To suggest a change kindly without sounding harsh.
Conversation
会話A
対応、拝見しました。全体的に良いと思います。
たいおう、はいけんしました。ぜんたいてきにいいとおもいます。
I looked at the response. Overall I think it's good.
B
ありがとうございます。気になる点はありましたか。
ありがとうございます。きになるてんはありましたか。
Thank you. Was there anything that concerned you?
A
ここはこうした方が読みやすいかもしれません。いかがでしょうか。
ここはこうしたほうがよみやすいかもしれません。いかがでしょうか。
This part might be more readable done this way. What do you think?
B
なるほど、確かにそうですね。修正します。
なるほど、たしかにそうですね。しゅうせいします。
I see, you're right. I'll fix it.
A
お願いします。反映できたら教えてください。
おねがいします。はんえいできたらおしえてください。
Please do. Let me know once you've applied it.
Vocabulary (10)
単語拝見はいけん
haiken
to look (humble)
拝見しました = humble "I looked at it."
全体的にぜんたいてきに
zentaitekini
overall
Frames a general impression.
気になるきになる
kininaru
to be concerned about
気になる点 = "points of concern."
読みやすいよみやすい
yomiyasui
easy to read
〜やすい attaches to a verb stem.
いかがでしょうかいかがでしょうか
ikagadeshouka
how about it? (polite)
Invites the other's opinion politely.
修正しゅうせい
shuusei
fix / correction
修正します = "I'll fix it."
反映はんえい
han'ei
reflecting / applying
変更を反映する = to apply changes.
資料しりょう
shiryou
materials / documents
資料を共有します = "I will share the materials."
締め切りしめきり
shimekiri
deadline
締め切りはいつですか = "When is the deadline?"
進捗しんちょく
shinchoku
progress
進捗はいかがですか = "How is the progress?"
Grammar
文法〜た方がいい
Verb ta-form + 方がいい
Suggests a better option: こうした方がいい = "better to do it this way."
〜かもしれません
Plain form + かもしれません
Softens to "might/maybe," making feedback gentle.
〜たら
Verb ta-form + ら
When/if: 反映できたら = "once you've applied it."
Cultural Notes
文化メモWorkplace etiquette
Japanese code review softens suggestions: 〜方がいいかもしれません + いかがでしょうか invites agreement rather than commanding.
Common mistake
Avoid blunt imperatives like 直して ("fix it"). They read as harsh even when technically correct.
Formality level
Polite. Praising first (全体的に良い) before suggesting changes is standard and keeps morale up.
Quiz
クイズ1. 「拝見」の意味は？
What does "拝見" mean?
2. 「全体的に」の意味は？
What does "全体的に" mean?
3. 「気になる」の意味は？
What does "気になる" mean?
4. 「読みやすい」の意味は？
What does "読みやすい" mean?
5. 「いかがでしょうか」の意味は？
What does "いかがでしょうか" mean?
6. 「修正」の意味は？
What does "修正" mean?
7. 文法「〜た方がいい」の使い方は？
How is the pattern "〜た方がいい" used?
8. 文法「〜かもしれません」の使い方は？
How is the pattern "〜かもしれません" used?
9. 文法「〜たら」の使い方は？
How is the pattern "〜たら" used?
10. この会話の目的は何ですか？
What is the goal of this conversation?
Flashcards
単語カードTurn this lesson into flashcards
Save all 10 vocabulary items to your deck and review them later with spaced repetition.