Beefy Boxes and Bandwidth Generously Provided by pair Networks
No such thing as a small change

comment on

( #3333=superdoc: print w/replies, xml ) Need Help??
It will take less of your time if:
  • The module is simple
  • The module is well-documented
  • The module is unpopular

If the module is complex, you will probably spend less time in the long run if you provide good documentation, including tutorials. Of course, there's always the users who don't read any documentation you give them, or who don't understand what you've written.

Of my three CPAN modules, one (Algorithm::Diff) has a (relatively) simple interface, one (Archive::Zip) is complex and has a big interface, and the last (Class::Prototyped has a relatively simple interface, but no one seems to be able to understand its use.

Of the three, Archive::Zip takes most of my support time (it is also the most popular). I didn't realize how popular it was until CPAN screwed up their index generation and started telling people to contact me for distributions <g>.

I would estimate that I have to answer 15 emails per week about the three modules. Occasionally I get one that causes me to have to work (like adding code to Archive::Zip that would repair damage caused by the Sircam virus).

In reply to Re: Module authors & time demands by bikeNomad
in thread Module authors & time demands by perigeeV

Use:  <p> text here (a paragraph) </p>
and:  <code> code here </code>
to format your post; it's "PerlMonks-approved HTML":

  • Are you posting in the right place? Check out Where do I post X? to know for sure.
  • Posts may use any of the Perl Monks Approved HTML tags. Currently these include the following:
    <code> <a> <b> <big> <blockquote> <br /> <dd> <dl> <dt> <em> <font> <h1> <h2> <h3> <h4> <h5> <h6> <hr /> <i> <li> <nbsp> <ol> <p> <small> <strike> <strong> <sub> <sup> <table> <td> <th> <tr> <tt> <u> <ul>
  • Snippets of code should be wrapped in <code> tags not <pre> tags. In fact, <pre> tags should generally be avoided. If they must be used, extreme care should be taken to ensure that their contents do not have long lines (<70 chars), in order to prevent horizontal scrolling (and possible janitor intervention).
  • Want more info? How to link or How to display code and escape characters are good places to start.
Log In?

What's my password?
Create A New User
Domain Nodelet?
and the web crawler heard nothing...

How do I use this? | Other CB clients
Other Users?
Others pondering the Monastery: (2)
As of 2023-06-07 03:02 GMT
Find Nodes?
    Voting Booth?
    How often do you go to conferences?

    Results (29 votes). Check out past polls.