Beefy Boxes and Bandwidth Generously Provided by pair Networks
Welcome to the Monastery

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 meditating upon the Monastery: (5)
As of 2018-06-23 12:46 GMT
Find Nodes?
    Voting Booth?
    Should cpanminus be part of the standard Perl release?

    Results (125 votes). Check out past polls.