I'd take a look at XML::Parser and how it does the documentation. It's gone through at least three authors, if not more.

When I took over PDF::Template, the changeset was nearly 99.9% of the code and the author didn't have time. Now, once you've taken over maintainership, you're the boss. Sure, you definitely have to look at backwards compatibility, but that's true if you originally wrote it or not.

Writing more tests, adding new build methods, reorganizing the directory ... as long as you're not ripping out stuff just because it ain't yours, I'd say go for it! If you're not sure, ask your users.

Oh, yeah - make sure you have a mailing list and that you invite anyone and everyone you can think of to be on it. And, make sure that mailing list is prominently listed in the POD. Mailing lists are an absolute MUST when you've got something opensource. GoogleGroups, Yahoo!Groups ... both are excellent free mailing lists. (Perl6 and Parrot both use GoogleGroups, if that tells you anything.)

Being right, does not endow the right to be rude; politeness costs nothing.
Being unknowing, is not the same as being stupid.
Expressing a contrary opinion, whether to the individual or the group, is more often a sign of deeper thought than of cantankerous belligerence.
Do not mistake your goals as the only goals; your opinion as the only opinion; your confidence as correctness. Saying you know better is not the same as explaining you know better.

In reply to Re: Adopting Modules by dragonchild
in thread Seekers of Perl Wisdom by PublicAccess

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


  • Posts are HTML formatted. Put <p> </p> tags around your paragraphs. Put <code> </code> tags around your code and data!
  • Titles consisting of a single word are discouraged, and in most cases are disallowed outright.
  • Read Where should I post X? if you're not absolutely sure you're posting in the right place.
  • Please read these before you post! —
  • Posts may use any of the Perl Monks Approved HTML tags:
    a, abbr, b, big, blockquote, br, caption, center, col, colgroup, dd, del, details, div, dl, dt, em, font, h1, h2, h3, h4, h5, h6, hr, i, ins, li, ol, p, pre, readmore, small, span, spoiler, strike, strong, sub, summary, sup, table, tbody, td, tfoot, th, thead, tr, tt, u, ul, wbr
  • You may need to use entities for some characters, as follows. (Exception: Within code tags, you can put the characters literally.)
            For:     Use:
    & &amp;
    < &lt;
    > &gt;
    [ &#91;
    ] &#93;
  • Link using PerlMonks shortcuts! What shortcuts can I use for linking?
  • See Writeup Formatting Tips and other pages linked from there for more info.