Re: Primer staged ready for review

Thank you for your comments, Paul!

I think you are right that the final overview of capabilities are a bit buried in section 3 and worth highlighting better.  On the other hand, the complete example would seem to belong in section 3.  How about the following:

Section 3.11 The Complete Example
Section 4: Summary of Capabilities of PROV

Best,

Yolanda


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



On Apr 3, 2013, at 7:40 AM, Paul Groth <p.t.groth@vu.nl> wrote:

> Hi Simona and Yolanda,
> 
> Here are my comments on the Primer.
> 
> Overall, this is a really great document and I'm happy for it to be the final primer. I especially like the example and how it fits together in the very end. Some detailed comments are below.
> 
> Thanks
> Paul
> 
> ===Comments===
> 
> Abstract
> 
> - We need to be more specific about what the Primer is for. I would say "PROV Data Model for provenance interchange on the web" and not "PROV specification". 
> 
> - "PROV is a core data model" change to "PROV defines a core data model"
> 
> Introduction
> - Again watch out for PROV specification
> - Third sentence, I would remove "proposed"
> - In the "agent-centered provenance" bullet point can you replace "entities" with something else like people/organzations ?
> - Do you want references to FOAF and Dublin core in the paragraph under the bullet points
> 
> Section 2.9
> - remove ", as below"
> 
> Section 3.1
> - do you want to put a pointer in the last paragraph to the graphical conventions on the wiki? 
> 
> Section 3.11
> - Why don't you use the correct extension for the turtle (.ttl) and prov-n (.provn) files that you link to?
> 
> I wonder if section 3.11 should be a Section 4. I find the capabilities of PROV to be really interesting and useful to know. A suggestion?
> 
> Section 4: Summary
> Section 4.1 The Complete Example
> Section 4.2 Capabilities of PROV
> 
> 
> 
> On Fri, Mar 29, 2013 at 6:36 PM, Miles, Simon <simon.miles@kcl.ac.uk> wrote:
> 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/
> 
> 
> 
> -- 
> -----------------------------------------------------------------------------------
> Dr. Paul Groth (p.t.groth@vu.nl)
> http://www.few.vu.nl/~pgroth/
> Assistant Professor
> - Web & Media Group | Department of Computer Science
> - The Network Institute
> VU University Amsterdam