Re^5: [OT] The joys of bad code

[hardburn]

in reply to Re^4: [OT] The joys of bad code
in thread The joys of bad code

If they can't program already, why are they digging around in code?

Over-documentation does make bad code. The documentation in the cases above is highly redundant with the actual code. Humans like some redundancy to keep communication robust, but there is a threshold where it just becomes silly. Flowerbox comments like the above go well past that point.

[Happy-the-monk]

why are they digging around in code?

We can never know, can we?
Just a happy guess: to learn from a code example?
Another one: to do something we would not want them to do?

I wasn't advocating that kind of documentation, if you thought I was -
But some managers strongly do that.
I do understand their views, even though I think they are flawed.

Cheers, Sören