(r11) TapRegExt10RFC < IVOA

IVOA Web>TapRegExt10RFC (revision 11) (raw view)~~EditAttach~~
---++ TAPRegExt-1.0 Proposed Recommendation: TCG Review

This document serves as the RFC center for the Proposed Recommendation entitled "TAPRegExt: a VOResource Schema Extension for Describing TAP Services, Version 1.0". 


The latest version of TAPRegExt:

   * http://www.ivoa.net/Documents/TAPRegExt/

---+++ Reference Interoperable Implementations

   * TOPCAT (client)
   * [[http://dc.g-vo.org][GAVO data center]] and the underlying software [[http://soft.g-vo.org/dachs][DaCHS software]] (server)
   * [[http://www.cadc.hia.nrc.gc.ca/tap/capabilities][CADC TAP service]]: the VOSI-capabilities resource includes extended metadata defined in TAPRegExt-1.0

---+++ Implementations Validators

Any schema validator will do for syntactic validation.  STILTS' taplint task does a partial semantic validation.

The !OpenCADC TAP library contains a !TAPRegExtParser that performs full schema validation on VOSI-capabilities documents with TAPRegExt extended metadata.


---+++ RFC Review Period: 14 February 2012 - 13 March 2012 (closed)

---+++ TCG Review Period: 16 March 2012 - 14 April 2012 (open)

<hr/>
<hr/>

---++ Comments from the IVOA Community during RFC period: 09 February 2012 - 08 March 2012

In order to add a comment to the document, please edit this page and add your comment to the list below in the format used for the example (include your Wiki Name so that authors can contact you for further information). When the author(s) of the document have considered the comment, they will provide a response after the comment.

Additional discussion about any of the comments or responses can be conducted on the WG mailing list. However, please be sure to enter your initial comments here for full consideration in any future revisions of this document 

   * Sample comment by TWiki.WikiName
      * Response (by TWiki.WikiName)

---+++ Comment from Mark Taylor
The example document in Appendix B has similar upload specifiers in two formats, e.g.
<verbatim>
<uploadMethod ivo-id="ivo://ivoa.org/tap/uploadmethods#http"/>
<uploadMethod ivo-id="ivo://ivoa.net/std/TAPRegExt#upload-http"/>
</verbatim>
The second form corresponds to the upload method sanctioned by this standard, but the first form corresponds to an earlier version of this standard.  Although it's legal to declare non-standard upload methods, and it might make some sense (for the near future) to have both versions in a production service to cope with clients written against the earlier version, it's confusing to have this in an example contained in the standards document.  I suggest removing the out-of-date versions and just retaining the ..std/TAPRegExt#.. uploadMethod elements in this example.  At the very least comment what these apparently redundant declarations are doing here.
-- IVOA.MarkTaylor - 09 Mar 2012

Oops -- that was an editorial oversight.  The obsolete ivo-ids 
are gone from current SVN (r1648).  
-- IVOA.MarkusDemleitner - 12 Mar 2012

<hr/>
<hr/>

---++ Comments from TCG member during the TCG Review Period: 16 March 2012 - 14 April 2012 


WG chairs or vice chairs must read the Document, provide comments if any and formally indicate if they approve or not the Standard.

IG chairs or vice chairs are also encouraged to do the same, althought their inputs are not compulsory.

---+++ TCG Chair & Vice Chair (<i>Christophe Arviset, Séverin Gaudet</i>)

A minor update should be made to the Architecture Diagram as VOSI has now been approved as a REC. I'll send the updated figure to the author.

I approve the document.
-- IVOA.ChristopheArviset - 20 Mar 2012

---+++ Applications Working Group (<i>Mark Taylor, Enrique Solano</i>)

There is a small number of errors:
   * All the schema snippets in the text lack the =xs:= prefix on close tags (e.g. =&lt;xs:sequence&gt;...&lt;/sequence&gt;= )
   * The upload example in Sec 2.5 says "...retrieving from ftp and http URLs..." but the example declaration lists http and inline upload types.
   * "Pricscilla" should read "Priscilla" in the [XSD] entry in the bibliography.

There are also a couple of issues related to VOTable:
   1 Sec 2.4 references the "yet-to-be-defined BINARY2 VOTable element"
   1 The example in Appendix B uses the parameterised MIME type =application/x-votable+xml;encoding=tabledata= . The definition of the "encoding" parameter for the VOTable MIME type has been discussed, but is not currently part of any standard.
Although it is still to be decided whether BINARY2 will be endorsed in a future version of VOTable, I think it's OK to include the qualified reference as it stands.  However, I'd be inclined to strip the parameter from the quoted MIME type in the example, especially since there is no explanation that this is not (currently) a standard usage.

Following consideration of these points, I'm happy to recommend acceptance of this carefully written document.
-- IVOA.MarkTaylor - 26 Mar 2012

Author comments:

   * prefix missing on closing tags: Fixed in ivoadoc, SVN rev. 1663
   * Upload example: Fixed in the prose
   * Bad reference: Thanks

On ==encoding=tabledata== -- I'd like to hear more opinions on this
before throwing it out (it would mean another edit to what is otherwise
basically a pretty-printed dump of a live and validated document, which
is one reason I'm reluctant).  For now, I've added prose clarifying it's
not an IVOA-endorsed MIME-type.

All changes should be in SVN rev. 1664.

-- IVOA.MarkusDemleitner - 27 Mar 2012

---+++ Data Access Layer Working Group (<i>Patrick Dowler, Mike Fitzpatrick</i>)

---+++ Data Model Working Group (<i>Jesus Salgado, Omar Laurino</i>)

---+++ Grid & Web Services Working Group (<i>Andreas Wicenec, Andre Schaaff</i>)

I'm happy to approve this.
-- IVOA.AndreasWicenec - 17 Mar 2012

---+++ Registry Working Group (<i>Gretchen Greene, Pierre Le Sidaner</i>)

---+++ Semantics Working Group (<i>Sebastien Derriere, Norman Gray</i>)

---+++ VOEvent Working Group (<i>Matthew Graham, John Swinbank</i>)

---+++ Data Curation & Preservation Interest Group (<i>Alberto Accomazzi</i>)

---+++ Knowledge Discovery in Databases Interest Group (<i>Giuseppe Longo</i>)

---+++ Theory Interest Group (<i>Herve Wozniak, Franck Le Petit</i>)

---+++ Standards and Processes Committee (<i>Francoise Genova</i>)


<hr/>

<br/>
<!--
      * Set ALLOWTOPICRENAME = %MAINWEB%.TWikiAdminGroup
-->
Topic revision: r11 - 2012-03-27 - MarkusDemleitner
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
Committees
Stds&Procs
www.ivoa.net
Documents
Events
Members
XML Schema