Hacker News new | ask | show | jobs
by rufus_foreman 1755 days ago
I went from my last job where every method and variable declaration had to be commented to my current job where there isn't a specific rule against comments in code but if you put in a PR with comments in it, you're going to get rejected after being laughed at.

I thought I would miss it, but I don't miss the documentation. Code doesn't lie.

4 comments

But code doesn't always explain why it is the way it is.
It does a hell of a lot better job than comments.

I can't believe you've got me justifying this policy. But it does seem to work. shrugs

You really can’t believe someone wants you to justify a stupid rule and toxic workplace environment?
Sounds like a toxic environment.
Comments like

x = 4 # Sets x to 4

Are of course silly and I'd laugh at them too, but comments when used correctly are hugely valuable.

Even a stale comment can be helpful in giving you a sense of what people were trying to do.

Do you not use commit messages either? Do you have any documentation at all?

You're an idiot.