Re: PROV-DM document

Thanks Luc, that makes sense.

Best,

Yolanda

Yolanda Gil, USC/ISI
+1-310-448-8794

On Apr 9, 2013, at 1:29 AM, Luc Moreau <l.moreau@ecs.soton.ac.uk> wrote:

> Hi Yolanda, all,
> 
> Thanks for this final review of prov-dm.
> 
> We have discussed capitalization at length.
> You are partially right.
> 
> I tried to summarize the capitalization conventions in the FAQ:
> http://www.w3.org/2001/sw/wiki/PROV-FAQ#Capitalization_Conventions_in_PROV
> 
> Given these,  figures 1, 5, 6, 7, 8, 10, and tables 2, 4, 5 are correctly capitalized.
> 
> When you say "types are always shown in lower case, except that Table 9 has all the types capitalized", it's not
> exactly true. Terms in definition are generally in lower case. However, table 9 lists types (i.e. classes) and therefore
> should be capitalized.
> 
> However, you were right that capitalization was not right in the definition of software agent, person, and organization.
> This is now fixed (as well as the typo):
> https://dvcs.w3.org/hg/prov/raw-file/default/model/releases/REC-prov-dm-20130430/diff.html#term-agent
> 
> 
> All, Feedback on the new FAQ entry appreciated,
> 
> Luc
> 
> 
> 
> On 04/09/2013 12:51 AM, Yolanda Gil wrote:
>> Luc, Paolo,
>> 
>> As we worked on the final version of the primer, I went over the PROV-DM document one more time in detail.  It reads very well, has very good examples and the tables and figures make it easy to follow.  My only suggestion to improve it at this point is to fix a typo: "prov:SoftareAgent".
>> 
>> I noticed that the PROV-DM document mostly follows the convention that we agreed to in using camel case with the first letter as lower case.  However, the document capitalizes the names of relations in some places: figures 1, 5, 6, 7, 8, 10, and tables 2, 4, 5.
>> 
>> Also, types are always shown in lower case, except that Table 9 has all the types capitalized, as does the introduction of agent-related concepts in the description of Component 3.
>> 
>> This is a minor point about following conventions uniformly, not a big problem but something I wanted to bring to your attention.
>> 
>> Yolanda
>> 
>> 
>> Yolanda Gil
>> Research Professor of Computer Science
>> Director of Knowledge Technologies, USC/ISI
>> Associate Director for Research, Intelligent Systems Division, USC/ISI
>> Information Sciences Institute
>> University of Southern California
>> 4676 Admiralty Way, Suite 1001
>> Marina del Rey, CA 90292 (USA)
>> Phone: +1-310-448-8794
>> Fax: +1-310-822-0751
>> http://www.isi.edu/~gil
>> 
>> 
>> 
> 
> -- 
> 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 Tuesday, 9 April 2013 14:08:27 UTC