I agree that changing the interface is *bad*. When writing, I would try to avoid it if at all possible, and if necessary, rename functions to fix this; another advantage of perl's weak typing is that it's probably very easy to 'overload' a function to take arguments in a different order if that is changed, but again, I would (and will) try to avoid that. That said, there's other options to consider.

That said, another thing that I've been doing, and a lot of others on CPAN apparently, is keeping the version number of what I would consider to be "use at your own risk" code at 0.xx. Once the code hits 1.xx, or any higher number, there's an implicit understanding that the code is well tested, and any additional updates are bug fixes and feature improvements, over mechanistic and behavior changes (until, of course, the next major number change). Certainly this is informal, but it seems to be consistent for module developers. Can this be a reasonable guarntee, particularly for newer (< 3 month old) modules that might yet have a large in-use distribution?

-----------------------------------------------------
Dr. Michael K. Neylon - mneylon-pm@masemware.com || "You've left the lens cap of your mind on again, Pinky" - The Brain
"I can see my house from here!"
It's not what you know, but knowing how to find it if you don't know that's important

In reply to Re: Re (tilly) 1: Introducing beta code into CPAN modules by Masem
in thread Introducing beta code into CPAN modules by Masem

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.