News for hackers. Stuff that matters.
Re:How to do a code review by mytailorisrich on Friday September 06, 2019 @04:53AM (#20894082)
A code review is not the time and place to report positive or convoluted comments. A code review is to find issues and to report them clearly.

The only positive thing to report should thus be that all is fine if the reviewer did not find any issues.

Now, if you are conducting the review in a meeting then obviously you can make oral comments in passing. If you're using a software tool for reviews then the all the comments should be on point. Nothing prevent you from talking to your coworker afterwards to spread some love if you want to.

Re:How to do a code review by afarrell on Friday September 06, 2019 @08:13AM (#20894924)
> A code review is not the time and place to report positive ... comments.

Why not?

(Convoluted comments should be made more concise)

Re:How to do a code review by mytailorisrich on Friday September 06, 2019 @08:28AM (#20895016)
Because a code review is not to pat each other on the back, it is to inspect and report issues. It is already costly enough without going off topic.

As said, if you want to praise then you are free to do it offline.

This is a professional procedure in a professional setting, not warm words from an encouraging teacher at school... I don't want to have to go through comments that do not add any value to the exercise of finding issues, and I have never seen people leave such comments in 20 years.

Re:How to do a code review by jsolson on Friday September 06, 2019 @10:22AM (#20895865)
> This is a professional procedure in a professional setting, not warm words from an encouraging teacher at school...

Citing a good practice in someone's code as "yes, please do more of this" alongside "don't do this please" is not, in my opinion, fluff.

> I don't want to have to go through comments that do not add any value to the exercise of finding issues, and I have never seen people leave such comments in 20 years.

So only pay attention to unresolved comments?

Re:How to do a code review by mytailorisrich on Friday September 06, 2019 @10:30AM (#20895932)
> Citing a good practice in someone's code as "yes, please do more of this"

That simply isn't the purpose of a code review.

Good practices should be documented externally, so you can check them consistently during code review ;) It's also quite useful to have a checklist when doing a code review.

Re:How to do a code review by jsolson on Friday September 06, 2019 @10:17AM (#20895826)
I disagree, with a caveat. Assuming your review tool supports "Resolved" or "No Action Required" comments (ours does), it's rather easy to distinguish something that is informative from something that is actionable. I am now recalling that some review tools don't distinguish open/unresolved comments from resolved or informative comments, which would make this more of a trade-off than an obvious win.