I saw a link to this page from Digg, listing 10 pieces of programming advice that should not be followed. One of them regards commenting (emphasis mine): 6) “Write lots of comments” Make sure you comment your code. Otherwise, it will be impossible for anyone to understand – including yourself in a year or so. [...]