Beefy Boxes and Bandwidth Generously Provided by pair Networks
laziness, impatience, and hubris

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 all is quiet...

How do I use this? | Other CB clients
Other Users?
Others scrutinizing the Monastery: (6)
As of 2017-08-21 14:32 GMT
Find Nodes?
    Voting Booth?
    Who is your favorite scientist and why?

    Results (324 votes). Check out past polls.