version numbers
Martin Hill
mchill at dial.pipex.com
Thu Apr 1 04:40:45 PST 2004
Throw in my opinion (how unusual) in support of Ray:
1) the numbering scheme that says that 0.10 is the version after 0.9 is
reasonably common and gives all the flexibility we need. Limiting
ourselves to one digit creates problems as Ray says with depth and with
what happens after v0.9. Please please lets have a consistent pattern
that lets us say v0.17 is after v0.7.3
2) Keeping the human document and associated schemas, WSDLs, etc
versions the same makes life so much easier for the users of these
documents! Given that we are setting *a* standard at each version
change, then the whole set of documents describing that standard should
make it clear they belong to that version of that standard.
Cheers
MC
Ray Plante wrote:
> Hi Marco,
>
> On Thu, 1 Apr 2004, Marco C. Leoni wrote:
>
>>- do we really need 10000 versions in between ver. 0.1 and the first
>>published WD (i.e. ver. 1.0)?
>
>
> No, of course not. But I expect that it won't be uncommon that we'll
> need more than ten.
>
>
>>- the documents process does not take into account the xml files et
>>similia: they are "supplementary resources" that means you can follow
>>your preferred numbering schema (CVS, RCS, VSS, etc.).
>
>
> In some cases where a document has an associated standard schema (e.g.
> ADQL), it would advantageous to have the XML version track the document
> version. Even in general, people will want to just adopt one system as a
> matter of practice.
>
> Consider the situation of VOResource, whose version now sits at 0.9. We
> have a choice between whether to make a major fundemental change to the
> core model or just an incremental change. (This is not hypothetical.)
> In my suggested system, it's a choice between going to 0.10 or 0.9.1. In
> the IVOA system, I'm pretty much forced to go to 0.91.
>
> Is there functional disadvantage to my system?
>
> (I hope I'm not overblowing this one.)
>
> cheers,
> Ray
>
>
>
>>
>>Cheers,
>> Marco
>>
>>
>>
>>
>>Ray Plante wrote:
>>
>>
>>>Hi Bob, Markus, Marco,
>>>
>>>I know I should have said something earlier, so feel free to say, "it's
>>>too late to change it."
>>>
>>>Thanks for the acknowledgement in the Guidelines Note regarding version
>>>numbers; however, you modified my suggestion in toward a direction I was
>>>trying to get away from. The convention of having 0.21 come between 0.2
>>>and 0.22 has a real problem: you only get ten revisions of a particular
>>>level. What comes after 0.99 if you are not ready for 1.0? 0.991? Or
>>>are you out of luck? The result is that you no longer have a sense of how
>>>major a change the revision is.
>>>
>>>The point of *my* saying "fields on either side of the period (.) are
>>>integers" is to say that 3 comes between 2 and 4, and 21 come between 20
>>>and 22. All increments between a set of periods are considered the same
>>>level of change.
>>>
>>>This is how RCS, CVS, and probably most other revision control systems
>>>work.
>>>
>>>cheers,
>>>Ray
>>>
>>
>
>
More information about the stdproc
mailing list