ISSUE-58: R2RML doesn't introduce Turtle well enough

turtle-introduction

R2RML doesn't introduce Turtle well enough

State:

CLOSED

Product:

Editorial

Raised by:

Richard Cyganiak

Opened on:

2011-07-25

Description:

(Originally raised by Sören)

The R2RML spec assumes familiarity with Turtle, as stated in the introduction.

Nevertheless, one can *mostly* understand the R2RML spec while knowing very little Turtle. To read most of the spec, and to make simple changes to existing mapping documents, or even to create a complete mapping file by copy-pasting stuff, one really only needs to understand the concept of objects that are nested and have named keys.

There are a few places that break this understanding by diving deeper into Turtle details without sufficient explanation or examples. Smoothing them out would make the spec more accessible.

The following two concrete occurrences were pointed out:

1. The following commentary in 2.3:
http://www.w3.org/2001/sw/rdb2rdf/r2rml/#example-mapping

[[
To complete the mapping document, the DEPT table needs to be mapped in a triples map called <#TriplesMap2>, which is already referenced above.
…
The definition of <#TriplesMap2> follows.
]]

2. The following note in 4.2:
http://www.w3.org/2001/sw/rdb2rdf/r2rml/#syntax

[[
It is common to use document-local IRIs in mapping documents by defining the default prefix in the beginning of the document, and using it for creating IRIs for mapping components such as triples maps:

@prefix : <#>
…
:EmpQuery rr:sqlQuery """SELECT * FROM EMP WHERE …""".
…
:EmpTriples rr:logicalTable :EmpQuery.
]]

Related Actions Items:

No related actions

Related emails:

1. Re: RDB2RDF WG agenda for 2011-11-29 meeting 1700 UTC (from bvillazon@fi.upm.es on 2011-11-29)
2. Re: RDB2RDF WG agenda for 2011-11-29 meeting 1700 UTC (from SOURIPRIYA.DAS@oracle.com on 2011-11-29)
3. RDB2RDF WG agenda for 2011-11-29 meeting 1700 UTC (from michael.hausenblas@deri.org on 2011-11-29)
4. Re: RDB2RDF WG agenda for 2011-11-08 meeting 1700 UTC (from richard@cyganiak.de on 2011-11-07)
5. Minutes of 2011-09-06 telecon (from michael.hausenblas@deri.org on 2011-09-06)
6. Re: RDB2RDF WG agenda for 2011-09-06 meeting 1600 UTC (from marcelo.arenas1@gmail.com on 2011-09-06)
7. Re: RDB2RDF WG agenda for 2011-09-06 meeting 1600 UTC (from bvillazon@fi.upm.es on 2011-09-06)
8. Re: RDB2RDF WG agenda for 2011-09-06 meeting 1600 UTC (from juanfederico@gmail.com on 2011-09-06)
9. Re: RDB2RDF WG agenda for 2011-09-06 meeting 1600 UTC (from auer@informatik.uni-leipzig.de on 2011-09-06)
10. RDB2RDF WG agenda for 2011-09-06 meeting 1600 UTC (from michael.hausenblas@deri.org on 2011-09-06)
11. Re: RDB2RDF WG agenda for 2011-08-30 meeting 1600 UTC (from nuno.lopes@deri.org on 2011-08-30)
12. Re: RDB2RDF WG agenda for 2011-08-30 meeting 1600 UTC (from privera.salas@gmail.com on 2011-08-30)
13. Re: RDB2RDF WG agenda for 2011-08-30 meeting 1600 UTC (from marcelo.arenas1@gmail.com on 2011-08-30)
14. Re: RDB2RDF WG agenda for 2011-08-30 meeting 1600 UTC (from juanfederico@gmail.com on 2011-08-29)
15. RDB2RDF WG agenda for 2011-08-30 meeting 1600 UTC (from michael.hausenblas@deri.org on 2011-08-29)
16. Re: Remaining R2RML issues for Last Call (ISSUE-55, ISSUE-57, ISSUE-58) (from michael.hausenblas@deri.org on 2011-08-27)
17. Re: Remaining R2RML issues for Last Call (ISSUE-55, ISSUE-57, ISSUE-58) (from ashok.malhotra@oracle.com on 2011-08-27)
18. Remaining R2RML issues for Last Call (ISSUE-55, ISSUE-57, ISSUE-58) (from richard@cyganiak.de on 2011-08-27)
19. Re: Status of the R2RML document and going last call (from michael.hausenblas@deri.org on 2011-08-02)
20. Status of the R2RML document and going last call (from richard@cyganiak.de on 2011-08-02)
21. Re: RDB2RDF WG agenda for 2011-08-02 meeting 1600 UTC (from marcelo.arenas1@gmail.com on 2011-08-02)
22. Re: RDB2RDF WG agenda for 2011-08-02 meeting 1600 UTC (from ashok.malhotra@oracle.com on 2011-08-02)
23. RDB2RDF WG agenda for 2011-08-02 meeting 1600 UTC (from michael.hausenblas@deri.org on 2011-07-30)
24. ISSUE-58 (turtle-introduction): R2RML doesn't introduce Turtle well enough [R2RML] (from sysbot+tracker@w3.org on 2011-07-25)

Related notes:

Display change log