Beefy Boxes and Bandwidth Generously Provided by pair Networks
Problems? Is your data what you think it is?

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

by hardburn (Abbot)
on Oct 26, 2004 at 13:38 UTC ( #402580=note: print w/ replies, xml ) Need Help??

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.

"There is no shame in being self-taught, only in not trying to learn in the first place." -- Atrus, Myst: The Book of D'ni.

Comment on Re^5: [OT] The joys of bad code
Replies are listed 'Best First'.
Re^6: [OT] (and even more so) The joys of bad code
by Happy-the-monk (Abbot) on Oct 26, 2004 at 13:59 UTC

    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

Log In?

What's my password?
Create A New User
Node Status?
node history
Node Type: note [id://402580]
and the web crawler heard nothing...

How do I use this? | Other CB clients
Other Users?
Others scrutinizing the Monastery: (9)
As of 2015-11-25 19:34 GMT
Find Nodes?
    Voting Booth?

    What would be the most significant thing to happen if a rope (or wire) tied the Earth and the Moon together?

    Results (686 votes), past polls