Request for Comment: RegTAP v1.0

This document serves as the RFC center for the Proposed Recommendation entitled "Registry Relational Schema, Version 1.0". The version reviewed during the RFC can be found at http://www.ivoa.net/documents/RegTAP/20140227/index.html.

RFC Review period: March 14, 2014 - April 15, 2014
TCG Review period:
Exec Approved for REC:

To add a comment on the document, please edit this page and add your comment to the list below in the format used for the example (include your WikiName 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 Resource Registry mailing list, registry@ivoa.net. However, please be sure to enter your initial comments here for full consideration in any future revisions of this document

Notes on Implementations and Validaters

There is currently a validator test suite created for this standard, http://docs.g-vo.org/regtapval-2014-03.tar.gz

An implementation of this is available on the TAP services at http://dc.g-vo.org/tap and http://gavo.aip.de/tap (the basic underlying software is identical for those).

Comments from the community

• Sample comment by WikiName
  • Response (by WikiName)

Comments from MarkTaylor

Great job Markus et al. A few minor comments:

• Sec 1.1: 'The entire standard is now known as "IVOA relational registry schema"' - the title of the document has "IVOA Registry Relational Schema" (words in a different order) - is this an inconsistency?
• Figure 1 caption: "(tagged with RegTAP)" - the box in the figure is labelled "Relational Registry" not "RegTAP", so I think this is wrong.
• Sec 4: The prefix->namespace table does not appear to be in any discernable order - order it alphabetically either by prefix or by URI?
• Sec 7.1: The description of short_name contains the text "Applications may use to refer to this resource in a compact display." - words missing?
• Sec 7.1: It would be useful for reference if the the information about field formatting presented in the text of this section could be repeated in the descriptions column of the table. Specifically:
  • content_level, content_type, rights: note values are hash-separated (this is already done for waveband)
  • creator_seq: note names are semicolon-separated
• Sec 7.7: "The table_column table models the content of VOResource's column element" - I might be wrong, but I think that should read "VODataService's column element".
• Sec 7.7: "hence, this column will contain one of NULL, vs:TAPType, vs:SimpleDataType and vs:VOTableType" - since these will be lowercased by the time they appear in the RegTAP table, would it be less confusing to mention them in lower case in this text?
• Sec 7.8: "analoguos" -> "analogous"; "adviced" -> "advised".
• Sec 7.9: In the param_description description, "column's contents" should read "parameter's contents".
• Sec 7.10: "resoure" - "resource".
• Sec 8: The first parameter of the ivo_hashlist_has UDF is declared with the name "haslist"; I think that should read "hashlist".
• Appendix A: "suffient" -> "sufficient".
• Appendix A: This is a long list, and the possibility of typos etc is not negligable. Would it be a good idea to add at the start that in the case of a discrepancy between the xpaths in this list and the XML schemas defined by the relevant standards, one or other of those should be taken as normative?
• Appendix A: I see a /capability/testQuery/pos/lat for SIA, but no corresponding /capability/testQuery/pos/long (SSAP has both).

Thanks for the useful comments. I hope they're all considered in volute rev. 2497. On the question of precedence of xpaths, I'm now declaring XML schema xpaths as normative and promise Errata in case contradictions go unnoticed. -- MarkusDemleitner - 2014-04-01

Comments from TCG members during the TCG Review Period:

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 ( _Séverin Gaudet, Matthew Graham )

Applications Working Group ( _Mark Taylor, Pierre Fernique )

Data Access Layer Working Group ( Patrick Dowler, Mike Fitzpatrick )

Data Model Working Group ( _Jesus Salgado, Omar Laurino )

Grid & Web Services Working Group ( Andreas Wicenec, Andre Schaaff )

Registry Working Group ( _Gretchen Greene, Pierre Le Sidaner)

Semantics Working Group ( _Norman Gray, Mireille Louys)

Data Curation & Preservation Interest Group ( Alberto Accomazzi, Françoise Genova )

Education Interest Group ( _Massimo Ramella, Sudhanshu Barway )

Knowledge Discovery in Databases Interest Group ( George Djorgovski )

Theory Interest Group ( _Franck Le Petit, Rick Wagner )

Time Domain Interest Group ( _Matthew Graham, John Swinbank )

Standards and Processes Committee ( Françoise Genova )

<!--
* Set ALLOWTOPICRENAME = TWikiAdminGroup
-->