Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

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 :)


Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: