Beefy Boxes and Bandwidth Generously Provided by pair Networks
Perl Monk, Perl Meditation

Re^2: Our documentation sucks

by jimt (Chaplain)
on Apr 12, 2007 at 23:11 UTC ( #609782=note: print w/replies, xml ) Need Help??

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

I'm less concerned with some new protocol or format or something than just better docs. But that was my idealized example.

As for the nefarious purpose argument, I look at that as a future use thing. I want better docs so most users get their foot in the door, not so experienced hackers bend the module to their will. Get people using the module, then they'll try to worry about how to enhance it in the future.

Most of the good use cases up front, something that can be cut 'n pasted, and that'll take care of most things. By all means include the docs to hack it like crazy afterwards, but most docs seem to skew towards that at the expense of the n00bs.

Log In?

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

How do I use this? | Other CB clients
Other Users?
Others imbibing at the Monastery: (5)
As of 2017-10-22 17:49 GMT
Find Nodes?
    Voting Booth?
    My fridge is mostly full of:

    Results (274 votes). Check out past polls.