define logical source in core and add spec refs #141
Conversation
spec/docs/logicalSource.md
Outdated
| @@ -0,0 +1,11 @@ | |||
| # Defining Logical Sources | |||
|
|
|||
| A <dfn>logical source</dfn> is a function on a [=data source=] that provides data to be mapped to [=RDF triples=]. | |||
There was a problem hiding this comment.
Is it actually a function?
There was a problem hiding this comment.
Yeah maybe we need to define it more abstractly. How would you define it?
There was a problem hiding this comment.
A Logical Source is an abstract description for describing data access and iteration of a data source which is mapped to RDF quads.
- Logical Source is a term -> caps
- RDF quads -> triples implies no Named Graph support
WDYT?
There was a problem hiding this comment.
A Logical Source is an abstract description for describing data access and iteration of a data source which is mapped to RDF quads.
I then suggest:
| A <dfn>logical source</dfn> is a function on a [=data source=] that provides data to be mapped to [=RDF triples=]. | |
| A <dfn>logical source</dfn> is an abstract construct to describe data access and iteration for a [=data source=] such that it can be mapped to [=RDF triples=]. |
- Logical Source is a term -> caps
I prefer to keep it lower case, but have all occurrences of terms linked to the definitions. Otherwise there will be a lot of caps in sentences, which IMO does not aid readability
- RDF quads -> triples implies no Named Graph support
I know @andimou wants to keep the text close to the R2RML rec. There the term RDF triple is used throughout. Also, I'm not sure there is an authorative definition of quad anywhere in the W3C recs.
There was a problem hiding this comment.
I like the suggested change! The word 'function' is tricky as it might confuse people with rml-fnml.
I prefer to keep it lower case, but have all occurrences of terms linked to the definitions.
That's something we need to align across all specs. RML-IO prefers caps when it talks about classes like Logical Source, following the practices used in ontologies.
There the term RDF triple is used throughout.
Yeah that's fine for me as well, aligns with Triples Maps though.
There was a problem hiding this comment.
That's something we need to align across all specs. RML-IO prefers caps when it talks about classes like Logical Source, following the practices used in ontologies.
OK. Core is quite heavy on definitions and references to defined terms. So I think it's more of an issue there.
There was a problem hiding this comment.
It would be great if we can coordinate across all specs the same approach to not confuse readers?
No description provided.