Re: shapes-ISSUE-165 (shapes and scopes introduction): [EDITORIAL] The introduction of shapes and scopes has confused a reader [SHACL Spec]

I think this comes under the "wrong use of verbs" category, which 
happens at various points in the document. I believe I removed them from 
the very early sections, but I didn't get beyond 2.2.n in the document 
before I crashed. If we can agree that shapes, scopes, nodes, etc. do 
not "act" then a general clean-up of that wording can be done.

kc

On 5/19/16 1:47 PM, RDF Data Shapes Working Group Issue Tracker wrote:
> shapes-ISSUE-165 (shapes and scopes introduction): [EDITORIAL] The introduction of shapes and scopes has confused a reader [SHACL Spec]
>
> http://www.w3.org/2014/data-shapes/track/issues/165
>
> Raised by: Peter Patel-Schneider
> On product: SHACL Spec
>
> The beginning of Section 2 has confused an external reviewer.
>
>>From https://lists.w3.org/Archives/Public/public-rdf-shapes/2016May/0000.html
>
>> 2. Shapes
>>
>>    The first paragraph says:
>>
>>      "Shape scopes define the selection criteria"
>>
>>    but then Figure 1 says:
>>
>>      "Scope selects focus nodes"
>>
>>    If a shape is just a graph (or part of a shapes graph), then surely that
>>    graph cannot actually perform a action, like "selects", as if executed like a
>>    Java method.  Figure 1 also talks about filter shapes that "refine" or
>>    "eliminate" and constraints that "produce".  Talking about graphs as agents
>>    is deeply confusing.
>>
>>      "Class-based scopes define the scope as the set of all instances of a
>>      class."
>>
>>    Okay, yes... classes have extensions... after all, RDF Schema 1.1 says that
>>    "Associated with each class is a set, called the class extension of the
>>    class, which is the set of the instances of the class" [3].  But what does
>>    this have to do with defining the set of focus nodes for a shape?  The scope
>>    of a shape is _not_ a specific data graph but the set of all instances of a
>>    class in the world?
>
>
>
>

-- 
Karen Coyle
kcoyle@kcoyle.net http://kcoyle.net
m: 1-510-435-8234
skype: kcoylenet/+1-510-984-3600

Received on Friday, 20 May 2016 02:01:59 UTC