Does anyone comment to that degree?<p>My general policy is to follow the "Use meaningful names" policy and use that as the commenting. The meaningful names of the function give you an idea of what they do and what side effects they have. The meaningful names of the parameters tell you what they do.<p>Maybe it's not a perfect system, but I think it's a happy medium between eating up a lot of time commenting and having totally unreadable code