Versioning

Matthew Graham mjg at cacr.caltech.edu
Thu Jul 2 09:44:28 PDT 2009


Hi,

You might be aware that the Document Standards v1.2 PR has just  
completed its RFC (http://www.ivoa.net/cgi-bin/twiki/bin/view/IVOA/DocStdRFC2 
). I raised concerns about the proposed versioning scheme:

"The document now states that there is an integer increment in the  
version number in the case where subsequent versions are not backward  
compatible. "

and the response that has been posted is:

"The Committee agrees that the version numbering scheme is challenging  
when dealing with namespaces and WSDL, and leads to the conclusion  
that when IVOA standards describe web services or have associated XML  
schemas, with namespaces that when changed, cause software to break,  
then these changes must both be accompanied by an increment to the  
integer part of the document and the associated "supplementary" files.  
This would not affect most of the standards documents, and should not  
present any real logistical difficulty, as there are a sufficient  
number of integers available to support any number of revisions. "

This has greatest impact for this working group (GWS but I am also  
cross-posting to Semantics)  and essentially means that ALL (WD, PR,  
etc) versions of our specs with WSDL/XML/RDF documents (anything with  
a namespace) will only carry integer versions.

So, for example, the progression of VOSpace 2.0 would actually proceed  
as:

VOSpace 2 (first WD)
VOSpace 3 (second WD)
VOSpace 4 (third WD)
VOSpace 5 (first PR)
VOSpace 6 (second PR)
VOSpace 7 (final PR)
VOSpace 8 (REC)

The next version would then VOSpace 9, etc.

Although this is very much a procedural issue, I just wanted to flag  
it so that everyone is aware and happy with it before I approve.

	Cheers,

	Matthew



More information about the semantics mailing list