Beefy Boxes and Bandwidth Generously Provided by pair Networks
"be consistent"
 
PerlMonks  

Re^11: Perl Contempt in My Workplace

by eyepopslikeamosquito (Archbishop)
on May 06, 2021 at 11:00 UTC ( [id://11132140]=note: print w/replies, xml ) Need Help??


in reply to Re^10: Perl Contempt in My Workplace
in thread Perl Contempt in My Workplace

Can anyone provide a definitive reference on the meaning of version 1.0 in the Perl world, especially for CPAN modules? ... along with advice on how a CPAN module should advertise that it is stable, well-tested and not experimental.

As indicated here I'm eager to update Writing Solid CPAN Modules with decent versioning advice but have left this in the too hard basket for far too long. :)

I sympathise with the OP because in the mainstream software world, I've always believed that version 1.0 indicated a stable, supported, production (not development) release. For example, from SemVer:

The simplest thing to do is start your initial development release at 0.1.0 ... If your software is being used in production, it should probably already be 1.0.0. If you have a stable API on which users have come to depend, you should be 1.0.0.

Oh, and other cool Perl versioning references you may know of that are not mentioned here are also welcome.

Replies are listed 'Best First'.
Re^12: Perl Contempt in My Workplace
by hippo (Bishop) on May 06, 2021 at 22:28 UTC
    Can anyone provide a definitive reference on the meaning of version 1.0 in the Perl world, especially for CPAN modules?

    I very much doubt you will find that because I do not think such meaning exists.

    along with advice on how a CPAN module should advertise that it is stable, well-tested and not experimental.

    That one definitely does have an answer and it is release_status => 'stable'.


    🦛

Re^12: Perl Contempt in My Workplace
by haukex (Archbishop) on May 06, 2021 at 17:31 UTC

    Just my two cents:

    Can anyone provide a definitive reference on the meaning of version 1.0 in the Perl world, especially for CPAN modules?

    I've always thought it was pretty arbitrary, that is, TIMTOWTDI...

    advice on how a CPAN module should advertise that it is stable, well-tested and not experimental.

    That's a good question. Personally I would make a note in the POD and/or Changelog if a version is stable - though I tend to only release decently-tested stuff anyway. If I was giving advice to someone else, what you quoted from SemVer is probably good advice. And I wrote a bit about judging the quality of a CPAN module here. (Update: hippo also makes a good point here.)

    Oh, and other cool Perl versioning references you may know of that are not mentioned here are also welcome.

    My bookmarks on versioning modules currently are: 1182640 and 11114665.

Log In?
Username:
Password:

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

How do I use this?Last hourOther CB clients
Other Users?
Others learning in the Monastery: (2)
As of 2024-04-25 20:13 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    No recent polls found