diff --git a/docs/release_notes/issue1024-differentiation-giver-sender-props.md b/docs/release_notes/issue1024-differentiation-giver-sender-props.md new file mode 100644 index 00000000..f90378cc --- /dev/null +++ b/docs/release_notes/issue1024-differentiation-giver-sender-props.md @@ -0,0 +1,4 @@ + +### Minor Updates + +- Updated annotations to differentiate `gist:hasRecipient`/`gist:goesToAgent` and `gist:hasGiver`/`gist:comesFromAgent` and align definitions of `gist:goesToPlace`/`gist:goesToAgent` and `gist:comesFromPlace`/`gist:comesFromAgent`. Issue [#1024](https://github.com/semanticarts/gist/issues/1024). diff --git a/ontologies/gistCore.ttl b/ontologies/gistCore.ttl index 33ec6be1..dc6571d4 100644 --- a/ontologies/gistCore.ttl +++ b/ontologies/gistCore.ttl @@ -2167,9 +2167,13 @@ gist:comesFromAgent gist:Person ) ; ] ; - skos:definition "The party that is the source of something (e.g. a message, shipment, etc.)"^^xsd:string ; + skos:definition "Relates something to the originating agent."^^xsd:string ; + skos:example "A package is shipped by a person; a purchase order is emailed to a vendor by an organization."^^xsd:string ; skos:prefLabel "comes from agent"^^xsd:string ; - skos:scopeNote 'This is not the inverse of gist:goesToAgent. A message can be to someone. If we made it the inverse the person would be "from" the message'^^xsd:string ; + skos:scopeNote + "This is not the inverse of gist:goesToAgent, as both properties have the message or shipment as the subject."^^xsd:string , + "This property is intended to describe the physical or electronic transfer of something, such as a package or email, from one agent to another, whereas gist:hasGiver is typically used in more abstract contexts such as agreements, obligations, contracts, etc. However, there are contexts in which either may be appropriate, such as the giving of a gift."^^xsd:string + ; . gist:comesFromPlace @@ -2181,7 +2185,8 @@ gist:comesFromPlace gist:Place ) ; ] ; - skos:definition "Origin"^^xsd:string ; + skos:definition "Relates something to its place of origin."^^xsd:string ; + skos:example "A letter has a return address indicating its origin; a delivery route originates at a distribution center; a trail originates at the trailhead."^^xsd:string ; skos:prefLabel "comes from place"^^xsd:string ; . @@ -2607,9 +2612,13 @@ gist:goesToAgent gist:Person ) ; ] ; - skos:definition "The party that is the recipient of something (e.g. a message, shipment, etc.)"^^xsd:string ; + skos:definition "Relates something to the agent that receives it."^^xsd:string ; + skos:example "A package is sent to a person; a purchase order email is received by a vendor."^^xsd:string ; skos:prefLabel "goes to agent"^^xsd:string ; - skos:scopeNote 'This is not the inverse of gist:comesFromAgent. A message can be from someone. If we made it the inverse the person would be "to" the message'^^xsd:string ; + skos:scopeNote + "This is not the inverse of gist:comesFromAgent, as both properties have the message or shipment as the subject."^^xsd:string , + "This property is intended to describe the physical or electronic transfer of something, such as a package or email, from one agent to another, whereas gist:hasRecipient is typically used in more abstract contexts such as agreements, obligations, contracts, etc. However, there are contexts in which either may be appropriate, such as the recieving of a gift."^^xsd:string + ; . gist:goesToPlace @@ -2621,7 +2630,8 @@ gist:goesToPlace gist:Place ) ; ] ; - skos:definition "Destination"^^xsd:string ; + skos:definition "Relates something to its destination place."^^xsd:string ; + skos:example "A letter has an address indicating its destination; a segment of a delivery route terminates at a delivery location; a trail terminates at an intersection with another trail."^^xsd:string ; skos:prefLabel "goes to place"^^xsd:string ; . @@ -2706,8 +2716,10 @@ gist:hasGiver a owl:ObjectProperty ; rdfs:subPropertyOf gist:hasParticipant ; owl:propertyDisjointWith gist:hasRecipient ; - skos:definition "The active party, the one with the obligation or the one initiating the transfer"^^xsd:string ; + skos:definition "Relates something to the participant that originates it."^^xsd:string ; + skos:example "An offer is made by a giver; an obligation has a giver who is obligated to another person; a gift is presented by the giver."^^xsd:string ; skos:prefLabel "has giver"^^xsd:string ; + skos:scopeNote "This property is often used in abstract contexts such as agreements, obligations, contracts, etc., whereas gist:comesFromAgent is intended to describe the physical or electronic transfer of something, such as a package or email, from one agent to another. However, there are contexts in which either may be appropriate, such as the giving of a gift."^^xsd:string ; . gist:hasGoal @@ -2788,8 +2800,10 @@ gist:hasPhysicalLocation gist:hasRecipient a owl:ObjectProperty ; rdfs:subPropertyOf gist:hasParticipant ; - skos:definition "Relates the subject (e.g. a transfer, a message, a gift) to an entity that receives or is intended to receive it."^^xsd:string ; + skos:definition "Relates something to the participant that receives it or is intended to receive it."^^xsd:string ; + skos:example "An offer is made to a recipient; an obligation has a recipient to whom another person is obligated; a gift is bestowed upon a recipient."^^xsd:string ; skos:prefLabel "has recipient"^^xsd:string ; + skos:scopeNote "This property is used in abstract contexts such as agreements, obligations, contracts, etc., whereas gist:goesToAgent is intended to describe the physical or electronic transfer of something, such as a package or email, from one agent to another. However, there are contexts in which either may be appropriate, such as the giving of a gift."^^xsd:string ; . gist:hasSubtrahend