Re: version-0.77 and You

On Jul 15, 2009, at 20:08 , David Golden wrote:

> A copy of my edits is attached and I've put a copy on the QA Wiki:
>
> http://perl-qa.hexten.net/wiki/index.php/Version_POD

I think the term "dotted-decimal" is pretty confusing, especially when  
what you contrast that with is "decimal version numbers" (which  
includes a dot).  I suggest you call it "integers separated by dots"  
or "dotted-integers" for short.  I also think it would be a good idea  
to define early what this means instead of just assuming that's  
understood.

In the section about declaring versions in the traditional way (using  
decimal $VERSION) I suggest it's presented in the string form:

    our $VERSION = "1.02";

This is the recommended form as you don't get surprises when the  
version number turns into "1.10".

Instead of saying that you can keep doing this if you "do not intend  
to _ever_ change that", just say that there is no reason to use  
version unless you prefer the "dotted-integers" form.

--Gisle