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

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
Re^6: [OT] (and even more so) The joys of bad code
by Happy-the-monk (Monsignor) 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?
Username:
Password:

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

How do I use this? | Other CB clients
Other Users?
Others chilling in the Monastery: (7)
As of 2014-08-21 06:53 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    The best computer themed movie is:











    Results (128 votes), past polls