ISSUE-491: [external] feedback on prov:agent explanation.

[external] feedback on prov:agent explanation.

State:
CLOSED
Product:
PROV-O HTML
Raised by:
Timothy Lebo
Opened on:
2012-09-04
Description:
I was looking over the PROV-O writeup, and I want to raise two points.
Pleas forward appropriately, if you deem it appropriate.

If you search for "Property: prov:agent op" at
http://www.w3.org/TR/prov-o/ you find:

"The property used by a prov:AgentInfluence to cite the Agent that
influenced an Entity, Activity, or Agent."
1) A property is "used" by an agent influence to "cite"--is the agent
influence writing a specification?

Perhaps: "If x is in the prov:agent relationships with y, x is an
instance of AgentInfluence and y is an instance of Agent that
influenced an Entity, Activity, or Agent."

OR (either way should be based on an established and clear convention
for the document)

"An agent influence is in the prov:agent relationship with an agent
only if the agent influenced an Entity, Activity, or Agent."

2)For the first sentence the passage, that as the reader I assume is
to begin defining the prov:activity property, does not mention
prov:agent, it should. The passage that I mention in #1 is not in the
first passage, and in fact is after the example that is given. This is
confusing for the reader. If you are introducing and defining a
property, then define the property first. I see the same thing for
prov:activity. In searching for "Class: prov:AgentInfluence" I see
that the initial passage for prov:AgentInfluence is the same initial
passage for prov:agent and prov:activity. So perhaps this is part of
some auto formatting/convention?

Cheers,
Patrice
Related Actions Items:
No related actions
Related emails:
  1. Re: PROV-ISSUE-491: [external] feedback on prov:agent explanation. [PROV-O HTML] (from soiland-reyes@cs.manchester.ac.uk on 2012-11-09)
  2. Re: PROV-ISSUE-491: [external] feedback on prov:agent explanation. [PROV-O HTML] (from lebot@rpi.edu on 2012-11-05)
  3. trying to resolve ISSUE-491 (from l.moreau@ecs.soton.ac.uk on 2012-11-01)
  4. Re: PROV-ISSUE-491: [external] feedback on prov:agent explanation. [PROV-O HTML] (from soiland-reyes@cs.manchester.ac.uk on 2012-09-27)
  5. PROV-ISSUE-491: [external] feedback on prov:agent explanation. [PROV-O HTML] (from sysbot+tracker@w3.org on 2012-09-04)

Related notes:

No additional notes.

Display change log ATOM feed


Chair, Staff Contact
Tracker: documentation, (configuration for this group), originally developed by Dean Jackson, is developed and maintained by the Systems Team <w3t-sys@w3.org>.
$Id: 491.html,v 1.1 2013-06-20 07:37:48 vivien Exp $