The difficult part with comments is they are the only thing in the codebase that's not checked by the complier. Comments are something that should be used spari

The difficult part with comments is they are the only thing in the codebase that's not checked by the complier. Comments are something that should be used sparingly as the OP. They occasionally are useful but good code should be self commenting by choosing good names and structuring algorithms in a reasonable way. I think at the end of the day it's insane to expect the people that who were unable to express themselves clear in formal code will somehow gain the ability to express themselves clearly in informal comments.