I was reading CodingConventions and was reminded of certain computer science teachers I have known who insisted on MethodCommenting in student assignments. (Mmm, BigBlocksOfAsterisks.)  I rather think their students would have learned more had MethodCommenting been discouraged, and the assignment marked on whether the reader could understand it anyhow.  -- MartinPool