ISSUE-132: Improve the examples to make them more intuitive and of broader appeal in Provenance Data Model (PROV-DM) Draft

YolandaGil

Improve the examples to make them more intuitive and of broader appeal in Provenance Data Model (PROV-DM) Draft

State:

CLOSED

Product:

prov-dm

Raised by:

Yolanda Gil

Opened on:

2011-10-20

Description:

It seems to me we are using non-intuitive or incomplete notions in the examples, which will make our documents that much harder to be understood and therefore the standard adopted. I would suggest to use one or two scenarios of broad interest, for example publishing a web page that has diverse and rich content, or an example with linked data.

For instance, in Section 4.2: It says "A file is read by a process execution". The fact that a file being read is a ProcessExecution seems to me to be a very contrived example (I don't think we've ever discussed a provenance scenario where file reading was considered, because there are other more pressing processes to represent).

Another case: if evt1, evt2, etc are timestamps, why not label them t1, t2, etc so they don't have a label that makes them look like events?

Another case: Somewhere it mentions "spellchecked" as an attribute, if so we should really show how the spellchecker program plays a role in the provenance record so this attribute becomes so.

Another case: all the examples of agents are people, but agents can be other things (eg the Royal Society that is used in another section).

Related Actions Items:

No related actions

Related emails:

1. Re: PROV-ISSUE-132 (YolandaGil): Improve the examples to make them more intuitive and of broader appeal in Provenance Data Model (PROV-DM) Draft [Data Model] (from gil@isi.edu on 2012-04-17)
2. Re: PROV-ISSUE-132 (YolandaGil): Improve the examples to make them more intuitive and of broader appeal in Provenance Data Model (PROV-DM) Draft [Data Model] (from L.Moreau@ecs.soton.ac.uk on 2012-04-17)
3. Re: PROV-ISSUE-132 (YolandaGil): Improve the examples to make them more intuitive and of broader appeal in Provenance Data Model (PROV-DM) Draft [Data Model] (from L.Moreau@ecs.soton.ac.uk on 2012-03-09)
4. Re: PROV-ISSUE-132 (YolandaGil): Improve the examples to make them more intuitive and of broader appeal in Provenance Data Model (PROV-DM) Draft [Data Model] (from L.Moreau@ecs.soton.ac.uk on 2011-10-24)
5. PROV-ISSUE-132 (YolandaGil): Improve the examples to make them more intuitive and of broader appeal in Provenance Data Model (PROV-DM) Draft [Data Model] (from sysbot+tracker@w3.org on 2011-10-20)

Related notes:

No additional notes.

Display change log