Beefy Boxes and Bandwidth Generously Provided by pair Networks
Pathologically Eclectic Rubbish Lister
 
PerlMonks  

Re^2: Our documentation sucks

by j3 (Friar)
on Apr 20, 2007 at 06:30 UTC ( #611090=note: print w/ replies, xml ) Need Help??


in reply to Re: Our documentation sucks
in thread Our documentation sucks

... but I believe instead that a lot of people are too lazy to try to use a module than to write their own code.

When I see a module with really poor docs (either too little, or too disorganized, or what have you), the first thing I think is, "Is it really going to be worth it for me to slog through this? Can I reasonably expect that the design and the code is going to be any better than the docs in front of me right now?".

As a general guideline, for better or worse, people use first impressions to save them a lot of time and/or trouble in the long run. A module's docs are my first impression of said module.


Comment on Re^2: Our documentation sucks
Replies are listed 'Best First'.
Re^3: Our documentation sucks
by chromatic (Archbishop) on Apr 20, 2007 at 18:37 UTC

    I agree with you. I meant the tendency not to use any module, not the analysis of a particular module and the decision not to use it in specific.

Log In?
Username:
Password:

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

How do I use this? | Other CB clients
Other Users?
Others musing on the Monastery: (18)
As of 2015-07-07 17:13 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 (92 votes), past polls