News for hackers. Stuff that matters.
Re:Conventional Comments by hcarvalhoalves on Thursday April 30, 2020 @03:15AM (#23028266)
Is it really?

I can find instructions disguised as questions condescending, for example.

I believe no amount of wording will help if people are not trusting each other. I would rather work on team building than comment guidelines.

Re:Conventional Comments by Cthulhu_ on Thursday April 30, 2020 @04:17AM (#23028650)
But instructions are given by superiors, while code reviews (generally) by peers. If someone you don't respect starts barking "Change 'this' to 'that'", would you?

I mean sure, in some cases you can completely disassociate from the human side of code, disregard a comment's name in favor of objective truth or however you want to word it, but in a lot of instances you still have to share the same office with that person.

Re:Conventional Comments by brujoand on Thursday April 30, 2020 @03:41AM (#23028434)
Yes and no. It depends on the team and the culture. My favorite was when I worked in a team of only senior engineers we would leave comments like 's/this/that/g other than than LGTM'. This was all that was needed, no fluff.

In other teams, a comment like this would have meant a chat with HR. We can't make rules for these things, because people and thus teams are different.