Mark Gritter (markgritter) wrote,
Mark Gritter

You know...

Comments in code that say "this probably doesn't work" or "this was deliberately left unimplemented" are really not so useful. Because the only way they get read (outside of a code review) is by the following procedure:

1) Observe bad behavior.
2) Ponder long and hard about what might be causing such bad behavior.
3) Develop a theory and examine the code involved.
4) Discover comment explaining bad behavior and smack head with palm.

While it's gratifying to see my theory proven, it'd be a tad more useful if this knowledge were contained in some more useful fashion... or if, for example, the code LOGGED AN ERROR when the unimplemented case got hit.

Tags: geek
  • Post a new comment


    default userpic

    Your reply will be screened

    Your IP address will be recorded 

    When you submit the form an invisible reCAPTCHA check will be performed.
    You must follow the Privacy Policy and Google Terms of use.