bert, your teaching is a fine example of why so much programming is bad . .A good rule is that EVERY branch and EVERY loop should be documented. And IMO Jon's teachers were right to mark him down (mildly . .)
If comments are not updated that's poor code maintenance.
One person's "obvious" bit of code is someone else's nightmare . .
Why do you think Microsoft produce unmaintainable bloatware?? (OK, I'm guessing at that "why").
If your're on a programming course the object is to produce exemplary code, not just comprehensible code.
G.