News for hackers. Stuff that matters.

A comment on Semantic Code Reviews – Simple and direct comments without drama. Parent comment

Re:Semantic Code Reviews – Simple and direct comments withou... by Cthulhu_ on Monday August 14, 2023 @10:32AM (#37121478)
As a senior, you should be aware of the authority you have or that others perceive you have. Your comments will be perceived as authoritative and coming from experience.

And they might very well be! But just make sure you get a rapport with the reviewed party, and prefix or suffix the comment with a "just a suggestion" or an explicit "I'm not asking you to act on this remark". With a semantic review, you can shorten it to "nit:".

[ Parent | on HN ]
Re:Semantic Code Reviews – Simple and direct comments withou... by cantSpellSober on Thursday August 17, 2023 @12:25PM (#37164118)
> prefix or suffix the comment with a "just a suggestion"

That's what the article suggests, using "Suggestion:" as a prefix.

> or an explicit "I'm not asking you to act on this remark"

Same, the article suggests the "Remark:" prefix. Both are more terse than what you suggest here.

[ Parent | on HN ]