News for hackers. Stuff that matters.
Re:Conventional Comments by tomp on Wednesday April 29, 2020 @06:27PM (#23025258)
I'm guessing this is about Code Review comments?

I always assume my comments on others' PRs (and other people's comments on my Code Reviews) are "suggestions (non-blocking)", unless indicated otherwise. Shouldn't that be the default, really?

Re:Conventional Comments by kubanczyk on Wednesday April 29, 2020 @08:13PM (#23026150)
If you use gitlab for code reviews, it's actually the opposite. Each comment thread prevents a merge unless you hit the "Resolve thread" button. It's configurable, but AFAIR it's Gitlab's default.

Even though I also often use Github and Gerrit at my current job, everywhere we observe that convention that a comment is considered blocking unless indicated otherwise. This is because ~80% are typically blocking.

Re:Conventional Comments by tomp on Thursday April 30, 2020 @06:41AM (#23029435)
Interesting, so "passive-agressive" is already built-in. Meaning even commenting in a very innocuous style "I'm not sure if this is correct according to the style guide..." would prevent a merge.

I personally try to encourage both communication and responsibility. So I comment on pretty much everything I don't understand/like/agree with (i.e. over-communication, that's really the only way to ensure adequate communication because by over-communicating according to your standards you're more likely hitting the other person's communication standards, which are necessarily different from your own and fundamentally unknowable), but at the same time I encourage the other person to decide which comments they want to respond to (either by arguing or by changing the code), hence showing I trust them and encouraging their personal responsibility.

Re:Conventional Comments by andr3 on Thursday April 30, 2020 @10:40AM (#23031276)
I think "passive-aggressive" is a bit too strong. If you leave a comment, even if not blocking, resolving that discussing can simply be a signal that the author of the MR has acknowledged it.

The proposal of conventional comments simply clarifies intention and disambiguates it. It's like that salt and pepper question. How do you know which is in which? Regardless of your knowledge and assumptions, it depends on whoever filled them in. This clarifies that.

Re:Conventional Comments by H8crilA on Wednesday April 29, 2020 @06:42PM (#23025423)
Don't the tools you use allow for selecting whether a comment is blocking or not? This is like the #3 feature of code review software. #2 would be the "approve" button, and #1 would be showing the diff.
Re:Conventional Comments by joombaga on Thursday April 30, 2020 @10:50AM (#23031404)
GitHub doesn't.