Beefy Boxes and Bandwidth Generously Provided by pair Networks
No such thing as a small change

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.

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 lurking in the Monastery: (6)
As of 2016-10-23 03:33 GMT
Find Nodes?
    Voting Booth?
    How many different varieties (color, size, etc) of socks do you have in your sock drawer?

    Results (300 votes). Check out past polls.