Beefy Boxes and Bandwidth Generously Provided by pair Networks
Keep It Simple, Stupid
 
PerlMonks  

Re^2: Our documentation sucks

by j3 (Friar)
on Apr 20, 2007 at 06:30 UTC ( [id://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?
Username:
Password:

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

How do I use this?Last hourOther CB clients
Other Users?
Others having an uproarious good time at the Monastery: (4)
As of 2024-04-19 21:21 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    No recent polls found