C# comments tutorial [closed]

Question

I would like to know which one is the best material that I can hand out to my students about "C# comments".

Answer 1

Something that I read a while ago (and have lost track of where) is:

• Beginners comment nothing
• Apprentices comment the obvious
• Journeymen comment the reason for doing it
• Masters comment the reason for not doing it another way

Answer 2

This Post by Jeff Atwood on his blog Coding Horror goes into the purpose of comments in general. Something you might think is 'duh' really isn't -- especially in the 'real world' when you see comments like the one below:

//Connect to the Database
Db.Connect();

And of course, there's the corollary to that post: Coding Without Comments.