Beefy Boxes and Bandwidth Generously Provided by pair Networks
Your skill will accomplish
what the force of many cannot
 
PerlMonks  

Re: Our documentation sucks

by itub (Priest)
on Apr 13, 2007 at 13:39 UTC ( #609914=note: print w/ replies, xml ) Need Help??


in reply to Our documentation sucks

In general, I've had very good experiences with the documentation of CPAN modules. It almost always starts with a synopsis that includes a common and simple use case that you can tweak as desired (there are exceptions, of course). I've had a much harder time with documentation for some other languages (including some commercial ones), which simply consists of lists of methods or subroutines, without anything to tie them together or to tell you where to start.


Comment on Re: Our documentation sucks

Log In?
Username:
Password:

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

How do I use this? | Other CB clients
Other Users?
Others taking refuge in the Monastery: (6)
As of 2014-12-25 17:28 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    Is guessing a good strategy for surviving in the IT business?





    Results (161 votes), past polls