From b5471ae254f34b7034af2310c380ab91f2b8c0fc Mon Sep 17 00:00:00 2001 From: Kate Studzinski Date: Mon, 14 Oct 2024 19:02:55 -0400 Subject: [PATCH 1/6] Update defs, examples, and scope notes Add release notes --- ...1024-differentiation-giver-sender-props.md | 2 ++ ontologies/gistCore.ttl | 30 ++++++++++++++----- 2 files changed, 24 insertions(+), 8 deletions(-) create mode 100644 docs/release_notes/issue1024-differentiation-giver-sender-props.md 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..06c340c2 --- /dev/null +++ b/docs/release_notes/issue1024-differentiation-giver-sender-props.md @@ -0,0 +1,2 @@ +Update definitions, examples, and scope notes to differentiate `gist:hasRecipient`/`gist:goesToAgent` andd `gist:hasGiver`/`gist:comesFromAgent`. +Align definitions of `gist:goesToPlace`/`gist:goesToAgent` and `gist:comesFromPlace`/`gist:comesFromAgent` diff --git a/ontologies/gistCore.ttl b/ontologies/gistCore.ttl index f17edfa3..fdae06b3 100644 --- a/ontologies/gistCore.ttl +++ b/ontologies/gistCore.ttl @@ -2176,9 +2176,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 in motion to the agent that originated the motion."^^xsd:string ; + skos:example "A package is shipped by a person; a purchase order is sent 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 + "In general, 'gist:comesFromAgent' is intended for when the subject is in motion. However, there is some overlap in when 'gist:hasGiver' and 'gist:comesFromAgent' can be used, such as giving a gift."^^xsd:string , + '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 + ; . gist:comesFromPlace @@ -2190,7 +2194,8 @@ gist:comesFromPlace gist:Place ) ; ] ; - skos:definition "Origin"^^xsd:string ; + skos:definition "Relates something in motion or something that enables motion 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 ; . @@ -2612,9 +2617,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 in motion to the agent that receives it, concluding the motion."^^xsd:string ; + skos:example "A package is sent to a person; a purchase order is recieved by a seller."^^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 + "In general, 'gist:goesToAgent' is intended for when the subject moves. However, there is some overlap in when 'gist:hasRecipient' and 'gist:goesToAgent' can be used, such as recieving a gift."^^xsd:string , + '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 + ; . gist:goesToPlace @@ -2626,7 +2635,8 @@ gist:goesToPlace gist:Place ) ; ] ; - skos:definition "Destination"^^xsd:string ; + skos:definition "Relates something in motion or something that enables motion to its destination."^^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 ; . @@ -2711,8 +2721,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 "In general, 'gist:hasGiver' is intended for when the subject does not move. However, there is some overlap in when 'gist:hasGiver' and 'gist:comesFromAgent' can be used, such as giving a gift."^^xsd:string ; . gist:hasGoal @@ -2793,8 +2805,10 @@ gist:hasPhysicalLocation gist:hasRecipient a owl:ObjectProperty ; rdfs:subPropertyOf gist:hasParticipant ; - skos:definition "The recipient"^^xsd:string ; + skos:definition "Relates something to the participant that receives 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 "In general, 'gist:hasRecipient' is intended for when the subject does not move. However, there is some overlap in when 'gist:hasRecipient' and 'gist:goesToAgent' can be used, such as recieving a gift."^^xsd:string ; . gist:hasSubtrahend From 0342f9c4b55175e8f63485fa72bb16275ea1d07d Mon Sep 17 00:00:00 2001 From: kstudzin Date: Thu, 17 Oct 2024 13:40:23 -0400 Subject: [PATCH 2/6] Update docs/release_notes/issue1024-differentiation-giver-sender-props.md Co-authored-by: Rebecca Younes --- .../issue1024-differentiation-giver-sender-props.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/release_notes/issue1024-differentiation-giver-sender-props.md b/docs/release_notes/issue1024-differentiation-giver-sender-props.md index 06c340c2..1624a0b0 100644 --- a/docs/release_notes/issue1024-differentiation-giver-sender-props.md +++ b/docs/release_notes/issue1024-differentiation-giver-sender-props.md @@ -1,2 +1,4 @@ -Update definitions, examples, and scope notes to differentiate `gist:hasRecipient`/`gist:goesToAgent` andd `gist:hasGiver`/`gist:comesFromAgent`. -Align definitions of `gist:goesToPlace`/`gist:goesToAgent` and `gist:comesFromPlace`/`gist:comesFromAgent` + +### Minor Updates + +- Update 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). From 049d7cf498fabf462f0fe9f544dd88c7bfe13759 Mon Sep 17 00:00:00 2001 From: kstudzin Date: Thu, 17 Oct 2024 13:56:34 -0400 Subject: [PATCH 3/6] Apply suggestions from code review Co-authored-by: Rebecca Younes --- ontologies/gistCore.ttl | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/ontologies/gistCore.ttl b/ontologies/gistCore.ttl index fdae06b3..3abb3f9c 100644 --- a/ontologies/gistCore.ttl +++ b/ontologies/gistCore.ttl @@ -2177,11 +2177,11 @@ gist:comesFromAgent ) ; ] ; skos:definition "Relates something in motion to the agent that originated the motion."^^xsd:string ; - skos:example "A package is shipped by a person; a purchase order is sent by an organization."^^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 - "In general, 'gist:comesFromAgent' is intended for when the subject is in motion. However, there is some overlap in when 'gist:hasGiver' and 'gist:comesFromAgent' can be used, such as giving a gift."^^xsd:string , - '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 + "In general, 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 , + 'This is not the inverse of gist:goesToAgent, as both properties have the message or shipment as the subject.'^^xsd:string ; . From e1c2407fc38a3c88a90b6fb29a84cac31498da59 Mon Sep 17 00:00:00 2001 From: Kate Studzinski Date: Thu, 17 Oct 2024 14:49:19 -0400 Subject: [PATCH 4/6] Updates based on review comments --- ontologies/gistCore.ttl | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/ontologies/gistCore.ttl b/ontologies/gistCore.ttl index 3abb3f9c..cd484582 100644 --- a/ontologies/gistCore.ttl +++ b/ontologies/gistCore.ttl @@ -2176,12 +2176,12 @@ gist:comesFromAgent gist:Person ) ; ] ; - skos:definition "Relates something in motion to the agent that originated the motion."^^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 "In general, 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 , - 'This is not the inverse of gist:goesToAgent, as both properties have the message or shipment as the subject.'^^xsd:string + "This is not the inverse of gist:goesToAgent, as both properties have the message or shipment as the subject."^^xsd:string ; . @@ -2194,7 +2194,7 @@ gist:comesFromPlace gist:Place ) ; ] ; - skos:definition "Relates something in motion or something that enables motion to its place of 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 ; . @@ -2617,12 +2617,12 @@ gist:goesToAgent gist:Person ) ; ] ; - skos:definition "Relates something in motion to the agent that receives it, concluding the motion."^^xsd:string ; - skos:example "A package is sent to a person; a purchase order is recieved by a seller."^^xsd:string ; + skos:definition "Relates something 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 - "In general, 'gist:goesToAgent' is intended for when the subject moves. However, there is some overlap in when 'gist:hasRecipient' and 'gist:goesToAgent' can be used, such as recieving a gift."^^xsd:string , - '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 + "In general, 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 , + "This is not the inverse of gist:comesFromAgent, as both properties have the message or shipment as the subject."^^xsd:string ; . @@ -2635,7 +2635,7 @@ gist:goesToPlace gist:Place ) ; ] ; - skos:definition "Relates something in motion or something that enables motion to its 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 ; . @@ -2724,7 +2724,7 @@ gist:hasGiver 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 "In general, 'gist:hasGiver' is intended for when the subject does not move. However, there is some overlap in when 'gist:hasGiver' and 'gist:comesFromAgent' can be used, such as giving a gift."^^xsd:string ; + skos:scopeNote "In general, this property is 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 @@ -2808,7 +2808,7 @@ gist:hasRecipient skos:definition "Relates something to the participant that receives 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 "In general, 'gist:hasRecipient' is intended for when the subject does not move. However, there is some overlap in when 'gist:hasRecipient' and 'gist:goesToAgent' can be used, such as recieving a gift."^^xsd:string ; + skos:scopeNote "In general, 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 From 08efc0aaaee7a36adc08f32cac7d027a2010e047 Mon Sep 17 00:00:00 2001 From: Kate Studzinski Date: Thu, 17 Oct 2024 15:18:50 -0400 Subject: [PATCH 5/6] Fix typo --- ontologies/gistCore.ttl | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ontologies/gistCore.ttl b/ontologies/gistCore.ttl index cd484582..f9512550 100644 --- a/ontologies/gistCore.ttl +++ b/ontologies/gistCore.ttl @@ -2617,7 +2617,7 @@ gist:goesToAgent gist:Person ) ; ] ; - skos:definition "Relates something the agent that receives it."^^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 From 046498be2dda44101b4ef7396b3fa82ab3c79838 Mon Sep 17 00:00:00 2001 From: Kate Studzinski Date: Tue, 22 Oct 2024 18:53:40 -0400 Subject: [PATCH 6/6] Scope note rewording --- ontologies/gistCore.ttl | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/ontologies/gistCore.ttl b/ontologies/gistCore.ttl index f9512550..1ca3eb2f 100644 --- a/ontologies/gistCore.ttl +++ b/ontologies/gistCore.ttl @@ -2180,8 +2180,8 @@ gist:comesFromAgent 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 - "In general, 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 , - "This is not the inverse of gist:goesToAgent, as both properties have the message or shipment as the subject."^^xsd:string + "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 ; . @@ -2621,8 +2621,8 @@ gist:goesToAgent 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 - "In general, 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 , - "This is not the inverse of gist:comesFromAgent, as both properties have the message or shipment as the subject."^^xsd:string + "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 ; . @@ -2724,7 +2724,7 @@ gist:hasGiver 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 "In general, this property is 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 ; + 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 @@ -2808,7 +2808,7 @@ gist:hasRecipient skos:definition "Relates something to the participant that receives 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 "In general, 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 ; + 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