ISSUE-74: Re-organize the table in Appendix B.2

appendix-B2

Re-organize the table in Appendix B.2

State:

CLOSED

Product:

R2RML

Raised by:

Richard Cyganiak

Opened on:

2011-11-07

Description:

This is part of David's LC feedback:
http://lists.w3.org/Archives/Public/public-rdb2rdf-comments/2011Oct/0022.html

It's about the table in R2RML Appendix B.2. David says:

[[
* I found it a bit confusing to click on the property links (e.g. rr:child) and to be taken to another document (I expected the properties to be defined in the spec). Furthermore it is not clear to me (maybe I missed something?) whether this related document is normative: http://www.w3.org/ns/r2rml#

* But, actually it is quite useful from a user and implementor perspective to see a list of which _sets_ of properties are required. Meaning that either rr:object or rr:objectMap is required. One way to address this would be to list the shortcuts separately and define what underlying property they imply.
]]

At the F2F there was also some discussion on whether it would be possible to add the various unstated constraints explicitly to this section. David noted that the table as it existed in earlier drafts of R2RML (before Richard's Big Rewrite) was more useful in this regard.

Part of the reason why this is complicated is syntactic sugar. See related ISSUE-75.

So, the question is whether the B.2 table can be re-designed or augmented with additional text to make it more useful and avoid the click-through confusion.

Related Actions Items:

No related actions

Related emails:

1. Re: What issue does Revelytix have with the syntactic sugar for rr:tableName? (from richard@cyganiak.de on 2011-12-06)
2. Re: RDB2RDF WG agenda for 2011-11-29 meeting 1700 UTC (from bvillazon@fi.upm.es on 2011-11-29)
3. Re: RDB2RDF WG agenda for 2011-11-29 meeting 1700 UTC (from SOURIPRIYA.DAS@oracle.com on 2011-11-29)
4. RDB2RDF WG agenda for 2011-11-29 meeting 1700 UTC (from michael.hausenblas@deri.org on 2011-11-29)
5. Status update on LC comments and post-LC changes to R2RML (from richard@cyganiak.de on 2011-11-07)
6. ISSUE-74 (appendix-B2): Re-organize the table in Appendix B.2 [R2RML] (from sysbot+tracker@w3.org on 2011-11-07)

Related notes:

Display change log