In a world where comments are terse; if it takes longer to grok the code than it takes to read a comment, the comment is worthwhile. // this does x do_x(

In a world where comments are terse; if it takes longer to grok the code than it takes to read a comment, the comment is worthwhile. // this does x do_x() is a bad comment, however... // this does x OMG_WTF_function_call(rocket science maths & bitmask); is a good comment :)