Beefy Boxes and Bandwidth Generously Provided by pair Networks
Just another Perl shrine
 
PerlMonks  

Re^3: The problem of documenting complex modules.(Summation.)

by BrowserUk (Patriarch)
on Jul 07, 2015 at 22:11 UTC ( [id://1133651]=note: print w/replies, xml ) Need Help??


in reply to Re^2: The problem of documenting complex modules.(Summation.)
in thread The problem of documenting complex modules.

far outweighed by the complete lack of any semantic meaning to the resulting documentation.
the resulting volume of brutalist formal data churned out by such auto-documenters is enough to send anyone scurrying for sanctuary.

The worst part in my experience is that their use serves as a ready justifiction for not providing anything else.

It's like a car manufacturer supplying dealers with a comprehensive parts list, in place of Workshop manuals.

No other industry would get away with the practice.


With the rise and rise of 'Social' network sites: 'Computers are making people easier to use everyday'
Examine what is said, not who speaks -- Silence betokens consent -- Love the truth but pardon error.
"Science is about questioning the status quo. Questioning authority".
In the absence of evidence, opinion is indistinguishable from prejudice.
I'm with torvalds on this Agile (and TDD) debunked I told'em LLVM was the way to go. But did they listen!
  • Comment on Re^3: The problem of documenting complex modules.(Summation.)

Log In?
Username:
Password:

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

How do I use this?Last hourOther CB clients
Other Users?
Others having a coffee break in the Monastery: (6)
As of 2024-04-23 07:21 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    No recent polls found