How not to
comment code

After I graduated from college, I went to Blue Sky Productions (currently Looking Glass Studios) and worked on this game, Ultima Underworld. My main programming task was writing all the AI code. It was kind of hairy, and there was this one hairy part in particular -- I think it was where all the monsters would get together while you were sleeping and vote on what they thought of you -- anyway, it had lots of special cases and weird logic, and after I had written it I couldn't put it behind me fast enough.

Six months later, I realize that I'm going to have to muck with this code. "Man," I say to myself, "I sure hope that I commented this code well when I originally wrote it." So, with trepidation, I open up the file and look at the function in question, and there is exactly one comment in it, at the very top, and it says:

                  /* HA HA HA */

Go back to Dan's home page