Comments Suck and You Probably Write Too Many - Qvault
submitted 3 years ago by wagslane from (qvault.io)
[–][deleted] 1 insightful - 1 fun1 insightful - 0 fun2 insightful - 0 fun2 insightful - 1 fun - 3 years ago (0 children)
The examples were really simple code, of course nobody needs a comment to explain a function call.
[–]fschmidt 1 insightful - 1 fun1 insightful - 0 fun2 insightful - 0 fun2 insightful - 1 fun - 3 years ago (0 children)
Yes, if you need comments to explain your code, then your code is to complex. Write simple self-documenting code. The only exception is when you are forced to write a hack to work around some crappy interface. My typical comments are something like "fucking google" which makes clear that the following code is some hack for google.
use the following search parameters to narrow your results:
e.g. sub:pics site:imgur.com dog
sub:pics site:imgur.com dog
advanced search: by author, sub...
~2 users here now
Links:
[–][deleted] 1 insightful - 1 fun1 insightful - 0 fun2 insightful - 0 fun2 insightful - 1 fun - (0 children)
[–]fschmidt 1 insightful - 1 fun1 insightful - 0 fun2 insightful - 0 fun2 insightful - 1 fun - (0 children)