Beefy Boxes and Bandwidth Generously Provided by pair Networks
Problems? Is your data what you think it is?
 
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
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?
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 perusing the Monastery: (15)
As of 2015-07-30 17:12 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    The top three priorities of my open tasks are (in descending order of likelihood to be worked on) ...









    Results (273 votes), past polls