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

Thanks for picking up this, Tim, this looks good and ready to send as
response. I guess we close the issue once the commenter accepts it.

I'm on holiday until the 15th and won't be able to respond to all emails in
this period. Apologies for not catching Luc's request about this on the 1st.

-- 
Stian Soiland-Reyes
myGrid team, University of Manchester
http://soiland-reyes.com/stian/work
On 5 Nov 2012 14:55, "Timothy Lebo" <lebot@rpi.edu> wrote:

> Stian,
>
> I adopted your redefinition and wrote up the response at:
>
>
> http://www.w3.org/2011/prov/wiki/ResponsesToPublicComments#ISSUE-491_.28prov:agent.29
>
>
>
> prov-wg,
>
> The following response will become the WG's response unless I hear
> objections before tomorrow (Tue) afternoon UK time.
>
> Regards,
> Tim
>
>
> ISSUE-491 (prov:agent)
>
>    - Original email:
>    http://lists.w3.org/Archives/Public/public-prov-wg/2012Sep/0040.html
>    - Tracker: https://www.w3.org/2011/prov/track/issues/491
>    - Group Response:
>       - The redundant and confusing rdfs:comments were removed from
>       prov:{entity,activity,agent}
>       - Editor's definitions were added to prov:{entity,activity,agent}
>       in place of reusing the definition from
>       prov:{Agent,Entity,Activity}Influence, e.g.:
>          - *The prov:agent property references an prov:Agent which
>          influenced a resource. This property applies to an prov:AgentInfluence,
>          which is given by a subproperty of prov:qualifiedInfluence from the
>          influenced prov:Entity, prov:Activity or prov:Agent.*
>       - References:
>    - Changes to the document:
>       - http://dvcs.w3.org/hg/prov/rev/b4f53beb7914 - PROV-O added
>       editorsDefinition to prov:activity, prov:entity, prov:agent.
>       - http://dvcs.w3.org/hg/prov/rev/8b1359797129 - PROV-O removed
>       comments on subproperties of prov:influencer.
>       - Reflected in PROV-O HTML:
>          - http://aquarius.tw.rpi.edu/prov-wg/prov-o#agent
>          - http://aquarius.tw.rpi.edu/prov-wg/prov-o#entity
>          - http://aquarius.tw.rpi.edu/prov-wg/prov-o#activity
>
>
>
>
> On Sep 27, 2012, at 10:56 AM, Stian Soiland-Reyes <
> soiland-reyes@cs.manchester.ac.uk> wrote:
>
> Suggested replacement definition:
>
> The property prov:agent describes an prov:Agent which influenced a
> resource. This property applies to an prov:AgentInfluence, which is given
> by prov:qualifiedInfluence or its subproperties from the influenced
> prov:Entity, prov:Activity or prov:Agent.
>
>
>
> Tim - if I add this as a <editorsDefinition> to #agent - should I
> remove the  <sharesDefinitionWith
> rdf:resource="http://www.w3.org/ns/prov#AgentInfluence"/> ?
>
>
> If style is acceptable, I'll replicate it for prov:entity and
> prov:activity, as I agree with Patrice that just copying the
> *Influence definition makes it confusing.
>
>
> On Tue, Sep 4, 2012 at 3:32 PM, Provenance Working Group Issue Tracker
> <sysbot+tracker@w3.org> wrote:
>
> 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
>
>
>
>
>
>
> --
> Stian Soiland-Reyes, myGrid team
> School of Computer Science
> The University of Manchester
>
>
>
>