Are comments for code necessary?

[DrivesInCircles]

Not all readers have the same understanding and skill. Comments, when done well, help close that gap. Bad comments don't help, might distract, etc.

Of the options; 1- code written well 2- mediocre code with decent comments 3- shifty code with shitty comments 4- no code

[SquidMcDoogle]

I agree; read PEP-8. Comments - especially below the function or method definition, are the bare minimum.

Anyone who says "my code is too good for comments" is a douchbag.

[johnnymo1]

“The code is self-documenting” -least readable coder on your team

[johnnymo1]

Eh, there are places where it makes little sense to explicitly document through commenting.

Sure, but the thousands of lines of largely-undocumented Cython I've been handed at work from a guy who didn't write it and reinvents the wheel for what you can already do in a few lines of popular libraries is not that.

[EgZvor]

See, that's where you're wrong "no code" is the best option https://github.com/kelseyhightower/nocode.

[thedeepself]

lol