Tim,
Thanks very much for the suggestion. It's a good idea, as the explanation of alternate was quite brief. I've made the change you suggested [1].
Anyone else have comments on the proposed responses?
thanks,
Simon
[1] http://dvcs.w3.org/hg/prov/raw-file/default/primer/Primer.html#alternate-entities-and-specialization
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/
________________________________
From: Timothy Lebo [lebot@rpi.edu]
Sent: 03 November 2012 18:41
To: Miles, Simon
Cc: Provenance Working Group WG
Subject: Re: Proposed response to public comments on primer
Simon,
The rewrite on specialization is very nice.
In particular, the web page reader vs. author is very compelling to illustrate specialization.
Given that that example is so great, I think the following section would better serve as an example of alternate:
[[
If a file, F, is copied from one directory to another, we may want to say that these are both the same file, just in a different location. We may say that the file in the first directory, F1, is a specialization of F, and that the file in the second directory, F2, is a specialization of F. Note that it is the context (location) rather than content of the file that changes in this case.
]]
So, I would recommend swapping the last two paragraphs, and tweaking the above quoted paragraph to be an example of alternate (as both specializations of some location less some-content file F).
Regards,
Tim
On Nov 3, 2012, at 2:02 PM, "Miles, Simon" <simon.miles@kcl.ac.uk<mailto:simon.miles@kcl.ac.uk>> wrote:
Hello,
There are some public comments to respond to regarding the primer. Specifically, they concern the overview figure, which we have recently updated as discussed elsewhere [1] and the primer's explanation of specialization and alternate, which clearly confused the reviewer.
The draft responses are available on the wiki [2] and are copied below. Feedback is welcome. In particular, the subsection on specialization and alternate has been completely rewritten to try to give a clearer explanation [3], and it would be good to know what the WG thinks.
[1] http://www.w3.org/2011/prov/track/issues/574
[2] http://www.w3.org/2011/prov/wiki/ResponsesToPublicComments#PROV_Primer_.28Draft.29
[3] http://dvcs.w3.org/hg/prov/raw-file/default/primer/Primer.html#alternate-entities-and-specialization
Responses:
ISSUE-561 (Primer Section 2 figure)
Original email: http://lists.w3.org/Archives/Public/public-prov-comments/2012Jul/0010.html
Tracker: http://www.w3.org/2011/prov/track/issues/561
Group Response:
- Since (and partly prompted by) the reviewer comment, the Working Group has discussed the best form for the primer overview diagram.
- It was decided to change so that the overview image used by primer is no longer to be a copy of the one from the PROV-DM. This is because the intention is different: the primer aims to give just a very few concepts and relations to give an intuition ahead of the rest of the introduction.
- The figure has been changed to be a reduced version of the one used in the PROV-O specification, and no link between the diagrams in specs is now claimed.
References:
- For a history of the debates: see http://www.w3.org/2011/prov/track/issues/574
Changes to the document:
- Removed the claim in the primer text that the image is the same as the one in PROV-DM.
- Changed the primer key concepts (overview) image to be one with a reduced set of concepts and relations giving an introductory intuition.
ISSUE-562, ISSUE-563, ISSUE-564 (Specialization and alternates)
Original email: http://lists.w3.org/Archives/Public/public-prov-comments/2012Jul/0010.html
Tracker: http://www.w3.org/2011/prov/track/issues/561, http://www.w3.org/2011/prov/track/issues/562, http://www.w3.org/2011/prov/track/issues/563
Group Response
- In ISSUE-562 and ISSUE-563, the comment is that the primer text implies particular things which the reviewer believes to be untrue, but are actually correct implications.
- First, it is correct that specialization implies that the child entity inherits all of the attributes of the parent entity. It is the reviewer's counter-example that is an incorrect use of PROV: the "parent" entity of one version of a document is not the prior version of the document, but the document in general, i.e. independent of version. All versions of a document share the attributes of the document in general.
- Second, the fact that two specializations of a single general entity are alternates of each other is a common case that fits the PROV definition of "alternate", and the implication is again correct.
- The fact that the reviewer believed the implications to be incorrect suggests that the primer did not adequately explain the concepts.
- ISSUE-564 relates to the reviewer finding the listed possible uses of the alternate relation confusingly distinct. Again, this is probably due to an inadequate explanation of the alternate and specialization relations.
- The conclusion of the group is that the previous explanation of the concepts was not adequately clear.
References:
- Clarifying the meaning of alternate and its relation to specialization: http://lists.w3.org/Archives/Public/public-prov-wg/2012Oct/0091.html
Changes to the document:
- The intuitive introduction to specialization and alternate relations, Section 2.9, has been completely rewritten based around a few use cases each with more detail than present before. Specialization is introduced before alternate, as it more clearly gives the overall motivation for the relations. We believe this gives a clearer indication of what the relations mean, and in what cases they should be used.
- See http://dvcs.w3.org/hg/prov/raw-file/default/primer/Primer.html#alternate-entities-and-specialization
thanks,
Simon
Dr Simon Miles
Senior Lecturer, Department of Informatics
Kings College London, WC2R 2LS, UK
+44 (0)20 7848 1166
Efficient Multi-Granularity Service Composition:
http://eprints.dcs.kcl.ac.uk/1396/