(r6) WDNumberingNomenclature < IVOA

IVOA Web>IvoaTCG>WDNumberingNomenclature (revision 6) (raw view)~~EditAttach~~
<h3>TCG discussion about the WD Standards numbering nomenclature</h3>

As per section 3.5 of the IVOA Technical Assesment and Roadmap for 2008:
----
The numbering nomenclature of the working drafts of IVOA standards in preparation is not homogeneous across WGs and makes it quite confusing for people not used to it.

Although there are already some numbering schemes envisaged in sections 4 and 5 of the [[http://www.ivoa.net/Documents/Notes/DocStd/Procedures-20040425.html#WorkingDrafts][Guidelines and Procedures for IVOA Document Standards Management v1.0, dated 25th April 2004]], it would be useful to have a numbering nomenclature which clearly and immediately shows that a certain IVOA standard is a REC or in a WD. Of course, that would take place only for the new standardsto be produced.

Various options can be envisaged, so some discussion should take place within the TCG in coordination with the Standing Committee on Standards and Processes to determine a possible better scheme.
----

But we don't need to change the scheme if we feel that the current one is adequate, so each WG/IG chair should express clearly her/his choice :

1. I am happy with the existing scheme, so I will use it and make sure I enforce it for all future WDs.

2. I believe that the existing scheme could be improved, so I explain why and how I feel it could be improved.

----
TCG, [[%MAINWEB%.ChristopheArviset][Christophe Arviset]], [[%MAINWEB%.SeverinGaudet][Severin Gaudet]]
----
IVOA, [[%MAINWEB%.FabioPasian][Fabio Pasian]]
----
Applications, [[%MAINWEB%.TomMcGlynn][Tom McGlynn]], [[%MAINWEB%.MarkTaylor][Mark Taylor]]  
----
Data Access Layer, [[%MAINWEB%.KeithNoddle][Keith Noddle]], [[%MAINWEB%.JesusSalgado][Jesus Salgado]]  
----
Data Model, [[%MAINWEB%.MireilleLouys][Mireille Louys]], [[%MAINWEB%.AnitaRichards][AnitaRichards]] 
----
Grid and Web Sevices, [[%MAINWEB%.MatthewGraham][Matthew Graham]], [[%MAINWEB%.PaulHarrison][Paul Harrison]] 

Whilst I would not choose the current form of the document numbering if starting from scratch, I think that we can live with it if we change some practices slightly.

The main problem with current practice appears to be the conflict with the desire for a REC to be a 1.0 version and the (probable) necessary changes that are required for the transition from public WD -> REC. This requires a little planning on the part of each working group, in that it would be sensible when promoting a document to public WD and give it a version number of 0.9 rather than 1.0 as seems to be the current practice. Even with the deficiencies of the current numbering scheme this gives a headroom of 9 iterations of the document before it is forced to be a 1.0 version, and allows the transition from PR to REC to contain some changes to the document, rather than PR1.0 potentially being a different document to REC1.0, so that the version number of the document is a true indicator of different content.

I think that this proposal has the important side effect of encouraging slightly earlier promotion of a document outside of a working group, so that cross working group issues can be explored before the document becomes too solidified

[[%MAINWEB%.PaulHarrison]]
----
Registry, [[%MAINWEB%.RayPlante][Ray Plante]], [[%MAINWEB%.AurelienStebe][Aurelien Stebe]]
----
Semantics, [[%MAINWEB%.SebastienDerriere][Sebastien Derriere]], [[%MAINWEB%.NormanGray][Norman Gray]]  
----
VOEvent, [[%MAINWEB%.RobSeaman][Rob Seaman]], [[%MAINWEB%.AlasdairAllan][Alasdair Allan]]
----
VO Query Language, [[%MAINWEB%.PedroOsuna][Pedro Osuna]], [[%MAINWEB%.YujiSHIRASAKI][Yuji Shirasaki]]
----
VOTable, [[%MAINWEB%.FrancoisOchsenbein][Fran&ccedil;ois Ochsenbein]]
----
Standard and Processes, [[%MAINWEB%.FrancoiseGenova][Francoise Genova]]  
----
Astro RG, [[%MAINWEB%.MasatoshiOhishi][Masatoshi Ohishi]] 
----
Data Curation and Preservation, [[%MAINWEB%.BobHanisch][Bob Hanisch]]  

The comments above from GWS basically make sense, but I think it needs to be clarified that there are two semi-independent labels for documents: the version number and the status of WD, PR, or REC.  Thus, the first public release of a WD is supposed to be V1.0, which then progresses to PR V1.0 and REC V1.0.  Right now the status of WD, PR, or REC is not visible in the document name, but rather only by the color coding of links on the IVOA documents page.

I remain basically satisfied with the system we have.

----
Theory, [[%MAINWEB%.HerveWozniak][Herve Wozniak]], [[%MAINWEB%.ClaudioGheller][Claudio Gheller]]
----



<br/>
<!--
      * Set ALLOWTOPICRENAME = %MAINWEB%.TWikiAdminGroup
-->
Topic revision: r6 - 2008-11-17 - BobHanisch
IVOA
Log in or Register
IVOA.net
Wiki Home
WebChanges
WebTopicList
WebStatistics
Twiki Meta & Help
IVOA
Know
Main
Sandbox
TWiki
TWiki intro
TWiki tutorial
User registration
Notify me
Working Groups
Interest Groups
Time Domain
Committees
Stds&Procs
www.ivoa.net
Documents
Events
Members
XML Schema