Beefy Boxes and Bandwidth Generously Provided by pair Networks
Problems? Is your data what you think it is?

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.

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?

What's my password?
Create A New User
Node Status?
node history
Node Type: note [id://611090]
and all is quiet...

How do I use this? | Other CB clients
Other Users?
Others drinking their drinks and smoking their pipes about the Monastery: (7)
As of 2017-11-25 06:31 GMT
Find Nodes?
    Voting Booth?
    In order to be able to say "I know Perl", you must have:

    Results (355 votes). Check out past polls.