Instead of statements, I favor questions. Instead of "I, me, you, etc,", I favor communal "we, the code, the team." Be specific when possible. I try to focus on what should be done vs what shouldn't be done.
"Why did you not handle $situation" -> "how does this code handle $situation?"
"You shouldn't do $thing" -> "$thing has sharp edges, see $link-to-more-info. The general approach used in the code base is to $alternative."
Instead of statements, I favor questions. Instead of "I, me, you, etc,", I favor communal "we, the code, the team." Be specific when possible. I try to focus on what should be done vs what shouldn't be done.
"Why did you not handle $situation" -> "how does this code handle $situation?"
"You shouldn't do $thing" -> "$thing has sharp edges, see $link-to-more-info. The general approach used in the code base is to $alternative."