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

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

http://www.w3.org/2011/prov/track/issues/491

Raised by: Timothy Lebo
On product: PROV-O HTML

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

Received on Tuesday, 4 September 2012 14:32:04 UTC