Re: PROV-DM document

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 08:31:40 UTC