Re: Primer staged ready for review

Hi Simon and Yolanda,

I have read the primer, which reads very well, so well done.
Below are some minor comments that have to do more with the form than
the content.

Best,
khalid
*****************
Document reviewd:
https://dvcs.w3.org/hg/prov/raw-file/default/primer/NOTE-prov-primer-20130430/Overview.html

C1. I think the following sentence, which is now in Section 2.1 on
Entities will be better placed in Section 2.9 on Alternate: "Entities
may be described as having different attributes and be described from
different perspectives. For example, document D as stored in my file
system, the second version of document D, and D as an evolving
document, are three distinct entities for which we may describe
provenance. "

C2. Section 2.5 is on Roles, and that concept is not depicted in the
Figure in the beginning of Section 2. I think it will be better to
talk about roles in Section 2.3 (when talking about Usage and
Generation), and in Section 2.4, when talking about Agent and
Responsibilities.

C3. In the title of Section 2.6 on Derivation and Revisiion, we may
need to add "Quotation" in the title, as it is mentioned in the body
of the section.

C4. In Section 3 on Examples and Key Concepts, I think it will be good
to have a small paragraph in the introduction of this Section that
describes briefly the examples that will be used in the subsection, as
well as the different namespaces used in the examples, such as
exc,axn, etc. The paragraph does not need to go into the details.



2013/3/29 Miles, Simon <simon.miles@kcl.ac.uk>
>
> Hello,
>
> The primer is now staged and ready for review:
>
>
> https://dvcs.w3.org/hg/prov/raw-file/default/primer/NOTE-prov-primer-20130430/Overview.html
>
> Please provide reviews by 4 April.
>
> thanks,
> Simon and Yolanda
>
> Dr Simon Miles
> Senior Lecturer, Department of Informatics
> Kings College London, WC2R 2LS, UK
> +44 (0)20 7848 1166
>
> Evolutionary Testing of Autonomous Software Agents:
> http://eprints.dcs.kcl.ac.uk/1370/

Received on Tuesday, 2 April 2013 10:11:28 UTC