W3C home > Mailing lists > Public > public-prov-wg@w3.org > October 2012

Re: Editorial error in the primer

From: Luc Moreau <l.moreau@ecs.soton.ac.uk>
Date: Mon, 01 Oct 2012 16:25:29 +0100
Message-ID: <EMEW3|d6b98d2e9d2db8fa7eb7ce25ccbe7f0fo90GPU08l.moreau|ecs.soton.ac.uk|5069B5E9.10106@ecs.soton.ac.uk>
To: Ivan Herman <ivan@w3.org>
CC: public-prov-wg@w3.org
Hi Ivan,

My experience with using this diagram and examples of provenance graphs 
is that it is crucial to
distinguish what is instance from what is schema.  People who come 
across provenance graphs for
the first time may easily regard them as schemas as opposed to  
instances of data structures.

So I am very confortable with a different notation being used for 
instance and schema.

If you think that this is problematic for the primer, then a figure such as
http://www.w3.org/TR/prov-o/#starting-points-figure
may be more suitable.

Of course, then another inconsistency potentially occurs, because 
Entity/Activity/Agent
will potentially have the wrong capitalization, depending on the 
serialization you look at.

   ex:dataset1    a prov:Entity .

   entity(ex:dataSet1)


Luc



On 01/10/2012 15:43, Ivan Herman wrote:
> Many (most?) people will start with the Primer, moving over to prov-o and, maybe, at some point to prov-dm. This is even the 'advice' the group gives to end users. The inconsistency is the first issue they hit...
>
> I know it is a pain because, I presume the figures are reused, but the primer should be consistent...
>
> I.
>
>
>
> On Oct 1, 2012, at 10:34 , Luc Moreau wrote:
>
>    
>> Hi Ivan,
>> Speaking of prov-dm only, which inconsistency? I don't see one: types are capitalized, instances are not.
>> Luc
>>
>> On 01/10/2012 15:02, Ivan Herman wrote:
>>      
>>> Luc,
>>>
>>> this is an editorial and non-normative issue I guess, so I will not make a problem of it. That being said, I do not really agree with the argumentation. If the UML rules lead to an inconsistency in the document, then my choice is to bend the UML rules. UML is in our documents for illustration only.
>>>
>>> Ivan
>>>
>>> On Sep 26, 2012, at 18:15 , Luc Moreau wrote:
>>>
>>>
>>>        
>>>> Hi Ivan,
>>>>
>>>> It's a figure from prov-dm.
>>>>
>>>> It's a compromise between various UML conventions and design decisions:
>>>> - we wanted to label binary associations with verbal form (wasGeneratedBy, wasAssociatedWith, etc)
>>>> - In UML, the expanded version with extra attribute is encoded as an association class
>>>> - Classes in UML are capitalized
>>>> - It is recommended to use the same name for the binary association and the corresponding association class.
>>>> - With all the above, we ended up with capitalized forms, such as WasGeneratedBy
>>>>
>>>> We know that that in prov-n we write this as wasGeneratedBy and in prov-o as prov:wasGeneratedBy.
>>>>
>>>> Luc
>>>>
>>>> On 26/09/12 21:46, Ivan Herman wrote:
>>>>
>>>>          
>>>>> The capitalization of the property names on the figure right before 2.1 is wrong. It should be wasGeneratedBy, wasAssociatedWith, etc, instead of WasGeneratedBy and WasAssociatedWith.
>>>>>
>>>>> Ivan
>>>>>
>>>>> ----
>>>>> Ivan Herman, W3C Semantic Web Activity Lead
>>>>> Home: http://www.w3.org/People/Ivan/
>>>>> mobile: +31-641044153
>>>>> FOAF: http://www.ivan-herman.net/foaf.rdf
>>>>>
>>>>>
>>>>>
>>>>>
>>>>>
>>>>>
>>>>>            
>>>> -- 
>>>> Professor Luc Moreau
>>>> Electronics and Computer Science   tel:   +44 23 8059 4487
>>>> University of Southampton          fax:   +44 23 8059 2865
>>>> Southampton SO17 1BJ               email: l.moreau@ecs.soton.ac.uk
>>>> United Kingdom                     http://www.ecs.soton.ac.uk/~lavm
>>>>
>>>>
>>>>
>>>>          
>>> ----
>>> Ivan Herman, W3C Semantic Web Activity Lead
>>> Home: http://www.w3.org/People/Ivan/
>>> mobile: +31-641044153
>>> FOAF: http://www.ivan-herman.net/foaf.rdf
>>>
>>>
>>>
>>>
>>>
>>>
>>>        
>> -- 
>> Professor Luc Moreau
>> Electronics and Computer Science   tel:   +44 23 8059 4487
>> University of Southampton          fax:   +44 23 8059 2865
>> Southampton SO17 1BJ               email: l.moreau@ecs.soton.ac.uk
>> United Kingdom                     http://www.ecs.soton.ac.uk/~lavm
>>
>>
>>      
>
> ----
> Ivan Herman, W3C Semantic Web Activity Lead
> Home: http://www.w3.org/People/Ivan/
> mobile: +31-641044153
> FOAF: http://www.ivan-herman.net/foaf.rdf
>
>
>
>
>
>    

-- 
Professor Luc Moreau
Electronics and Computer Science   tel:   +44 23 8059 4487
University of Southampton          fax:   +44 23 8059 2865
Southampton SO17 1BJ               email: l.moreau@ecs.soton.ac.uk
United Kingdom                     http://www.ecs.soton.ac.uk/~lavm
Received on Monday, 1 October 2012 15:26:04 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 21:58:19 UTC