[oslc-core] Ambiguity in Resource Shape definition + consequent questions

John Arwe johnarwe at us.ibm.com
Tue Jan 17 09:40:27 EST 2012


> I [Arthur] suggest this description: 
> 
> This shape describes resources that are of any of these types. That is, 
> the shape applies to resources that are in the union of the types. Note 
> that if a resource has multiple rdf:type properties then the resource is 

> in the intersection of those types. Therefore a shape S applies to a 
> resource R if R has a type T and there is a triple S oslc:describes T.

Pretty good.  I'm going to counter with some tweaks that I hope reduce 
ambiguity in the natural language portion; the final sentence's more 
formal version is great, and I'll tweak that to make it a bit more formal. 
 The union/intersection change is one to pay special attention to I 
suspect - "resources that are in the union of the types" throws me for a 
loop.

> This shape describes resources that are of any of these types. That is, 
> the shape applies to resources whose type(s) intersect with the shape's 
described type(s). 
> Formally, a shape S applies to a 
> resource R if there is a triple R rdf:type T and there is a triple S 
oslc:describes T.

Since we agreed during the WG call that it is intentional and valid to 
have zero oslc:describes triples in a shape (so the shape describes only 
resources that explicitly link to it via a oslc:instanceShape  triple), 
here is a new (full replacement) proposal for the consequent editorial 
changes to [1]:

Q2: (editorial change) 
A Resource Shape describes the properties that are allowed or required 
by...
from: one         type               of resource . 
to:   one or more types or instances of resources. 
I'm not entirely happy with that (seems a bit awkward still), 
but I think it's accurate now so I claim 80-20 reached 
and give license to the editor(s) to improve it.

Q3: answered - 0 intentional, no change

Q4: Another disagreement between the words and oslc:describes cardinality 
providing a machine-readable definition...
from: of an          OSLC resource type              . 
to:   of one or more OSLC resource types or instances. 
FWIW: I kept "resource type" there, but "resource definition" might be 
more in keeping with the rest of the specs' content... did not do a wide 
search. 

Q5: (editorial nit) 
OSLC Creation Factory MAY provide ...
from: a Resource Shape  ... create a resource 
to:     Resource Shapes ... create   resources 
...and a similar change for Query Capability in the next sentence. 

Q6: (editorial nit) 
from: A Resource Shape resource can have a title and a        type . 
to:   A Resource Shape resource can have a title and a set of types. 


[1] 
http://open-services.net/bin/view/Main/OSLCCoreSpecAppendixA?sortcol=table;table=up;up=#oslc_ResourceShape_Resource 



Best Regards, John

Voice US 845-435-9470  BluePages
Tivoli OSLC Lead - Show me the Scenario

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://open-services.net/pipermail/oslc-core_open-services.net/attachments/20120117/954f6f20/attachment-0003.html>


More information about the Oslc-Core mailing list