[quote name='Ghosrath' timestamp='1338469974']
I can suggest a very interesting piece of reading material.
Clean code by Robert C. Martin.
Especially chapter 4 on comments is great reading material [img]http://public.gamedev.net//public/style_emoticons/default/smile.png[/img]
Basically it states that every comment placed in code means that the code that is commented is actually bad code. Good code never needs any comments at all!
Try this and notice how much easier you can find certain pieces of code, just because you don't need to read through all the comments
A little quote:
Nothing can be quite so helpfull as a well-placed comment. Nothing can clutter up a module more than frivolous dogmatic comments. Nothing can be quite so damaging as an old crufty comment that propagates lies and misinformation.
Clean Code is an excellent book. Probably not for beginners, but once you've been coding long enough to groan when you look at your own code, it will help you see how not to. In particular, the concept of self documenting code (and unit tests as documentation) have done wonders for my style. If you can read each line of code aloud without feeling foolish you will almost never need to write a comment.