Refactored giver, getter and hasParty. Fixes #133

.gitignore

@@ -1,3 +1,4 @@
 *.~vsd*
 *_webDownload/
 .DS_Store
+*.orig

docs/ReleaseNotes.md

@@ -4,6 +4,22 @@ gist Release Notes
 Release X.x.x [UPDATE AT RELEASE TIME]
 -----
 
+### Minor Updates
+
+**Refactored `hasParty`, `giver` and `getter`**
+Issue [#133](https://github.com/semanticarts/gist/issues/133)
+
+- `giver` and `getter`
+  - Renamed to `hasGiver` and `hasGetter`
+  - The newly named versions are no longer subproperties of `hasParty`
+  - Deprecated
+- New property: `hasParticipant`
+  - No domain or range
+  - Has subproperties: `hasGiver`, `hasGetter`, `hasParty`, `fromAgent` and `toAgent`
+- Added a `skos:scopeNote` to `fromAgent` 
+- Added a `skos:example` to `hasParty`
+- Updated `skos:definition`s for `toAgent` and `fromAgent`
+
 ### Patch updates
 
 - Updated gist style guide for newly-defined conventions. Issue [#421](https://github.com/semanticarts/gist/issues/421).

gistCore.ttl

@@ -373,7 +373,7 @@ gist:Commitment
 			]
 			[
 				a owl:Restriction ;
-				owl:onProperty gist:giver ;
+				owl:onProperty gist:hasGiver ;
 				owl:someValuesFrom [
 					a owl:Class ;
 					owl:unionOf (
@@ -499,7 +499,7 @@ gist:ContingentObligation
 			gist:Commitment
 			[
 				a owl:Restriction ;
-				owl:onProperty gist:giver ;
+				owl:onProperty gist:hasGiver ;
 				owl:someValuesFrom [
 					a owl:Class ;
 					owl:unionOf (
@@ -1654,7 +1654,7 @@ gist:Obligation
 			gist:Commitment
 			[
 				a owl:Restriction ;
-				owl:onProperty gist:getter ;
+				owl:onProperty gist:hasGetter ;
 				owl:someValuesFrom [
 					a owl:Class ;
 					owl:unionOf (
@@ -1665,7 +1665,7 @@ gist:Obligation
 			]
 			[
 				a owl:Restriction ;
-				owl:onProperty gist:giver ;
+				owl:onProperty gist:hasGiver ;
 				owl:someValuesFrom [
 					a owl:Class ;
 					owl:unionOf (
@@ -1689,7 +1689,7 @@ gist:Offer
 			gist:ContingentObligation
 			[
 				a owl:Restriction ;
-				owl:onProperty gist:giver ;
+				owl:onProperty gist:hasGiver ;
 				owl:someValuesFrom [
 					a owl:Class ;
 					owl:unionOf (
@@ -3050,16 +3050,18 @@ gist:expressedIn
 
 gist:fromAgent
 	a owl:ObjectProperty ;
+	rdfs:subPropertyOf gist:hasParticipant ;
 	rdfs:range [
 		a owl:Class ;
 		owl:unionOf (
 			gist:Organization
 			gist:Person
 		) ;
 	] ;
-	skos:definition "The source of a message or shipment"^^xsd:string ;
+	skos:definition "The party that is the source of something (e.g. a message, shipment, etc.)"^^xsd:string ;
 	skos:prefLabel "from agent"^^xsd:string ;
-	.
+	skos:scopeNote 'This is not the inverse of toAgent. A message can be to someone. If we made it the inverse the person would be "from" the message'^^xsd:string ;
+    .
 
 gist:fromPlace
 	a owl:ObjectProperty ;
@@ -3107,21 +3109,6 @@ gist:geoOccupies
 	skos:prefLabel "geo occupies"^^xsd:string ;
 	.
 
-gist:getter
-	a owl:ObjectProperty ;
-	rdfs:subPropertyOf gist:hasParty ;
-	owl:propertyDisjointWith gist:giver ;
-	skos:definition "The recipient"^^xsd:string ;
-	skos:prefLabel "getter"^^xsd:string ;
-	.
-
-gist:giver
-	a owl:ObjectProperty ;
-	rdfs:subPropertyOf gist:hasParty ;
-	skos:definition "The active party, the one with the obligation or the one initiating the transfer"^^xsd:string ;
-	skos:prefLabel "giver"^^xsd:string ;
-	.
-
 gist:governedBy
 	a owl:ObjectProperty ;
 	owl:inverseOf gist:governs ;
@@ -3243,6 +3230,21 @@ gist:hasFromNode
 	skos:prefLabel "has from node"^^xsd:string ;
 	.
 
+gist:hasGetter
+	a owl:ObjectProperty ;
+	rdfs:subPropertyOf gist:hasParticipant ;
+	owl:propertyDisjointWith gist:hasGiver ;
+	skos:definition "The recipient"^^xsd:string ;
+	skos:prefLabel "Has Getter"^^xsd:string ;
+	.
+
+gist:hasGiver
+	a owl:ObjectProperty ;
+	rdfs:subPropertyOf gist:hasParticipant ;
+	skos:definition "The active party, the one with the obligation or the one initiating the transfer"^^xsd:string ;
+	skos:prefLabel "Has Giver"^^xsd:string ;
+	.
+
 gist:hasGoal
 	a owl:ObjectProperty ;
 	skos:definition "The reason for doing something"^^xsd:string ;
@@ -3309,16 +3311,29 @@ gist:hasPart
 	skos:prefLabel "has part"^^xsd:string ;
 	.
 
+gist:hasParticipant
+	a owl:ObjectProperty ;
+	skos:definition "Relates something (e.g. an agreement) to things that play a role, or take part or are otherwise involved in some way."^^xsd:string ;
+	skos:example "An event of transferring money has a participating account that receives the money."^^xsd:string ;
+	skos:prefLabel "Has Participant"^^xsd:string ;
+	skos:scopeNote
+		"The thing with participants will often be an agreement, event or obligation."^^xsd:string ,
+		"This is intended as an abstract property. Only its subproperties will be directly used."^^xsd:string
+		;
+	.
+
 gist:hasParty
 	a owl:ObjectProperty ;
+	rdfs:subPropertyOf gist:hasParticipant ;
 	rdfs:range [
 		a owl:Class ;
 		owl:unionOf (
 			gist:Organization
 			gist:Person
 		) ;
 	] ;
-	skos:definition "The people or organizations participating in an agreement or obligation"^^xsd:string ;
+	skos:definition "The people or organizations participating in an event, agreement or obligation"^^xsd:string ;
+	skos:example "For loan agreements, one might create hasLender and hasBorrower as subproperties of hasParty."^^xsd:string ;
 	skos:prefLabel "has party"^^xsd:string ;
 	.
 
@@ -3776,14 +3791,15 @@ gist:timeZoneStandardUsed
 
 gist:toAgent
 	a owl:ObjectProperty ;
+	rdfs:subPropertyOf gist:hasParticipant ;
 	rdfs:range [
 		a owl:Class ;
 		owl:unionOf (
 			gist:Organization
 			gist:Person
 		) ;
 	] ;
-	skos:definition "Indicates to whom (e.g. a message or shipment) is destined for."^^xsd:string ;
+	skos:definition "The party that is the recipient of something (e.g. a message, shipment, etc.)"^^xsd:string ;
 	skos:prefLabel "to agent"^^xsd:string ;
 	skos:scopeNote 'This is not the inverse of fromAgent. A message can be from someone. If we made it the inverse the person would be "to" the message'^^xsd:string ;
 	.

gistDeprecated.ttl

@@ -5,6 +5,7 @@
 @prefix owl: <http://www.w3.org/2002/07/owl#> .
 @prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
 @prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
+@prefix skos: <http://www.w3.org/2004/02/skos/core#> .
 @prefix xml: <http://www.w3.org/XML/1998/namespace> .
 @prefix xsd: <http://www.w3.org/2001/XMLSchema#> .
 
@@ -156,6 +157,23 @@ gist:geoDirectlyContains
 	owl:deprecated "true"^^xsd:boolean ;
 	.
 
+gist:getter
+	a owl:ObjectProperty ;
+	rdfs:subPropertyOf gist:hasParticipant ;
+	owl:deprecated "true"^^xsd:boolean ;
+	owl:propertyDisjointWith gist:giver ;
+	<http://www.w3.org/2004/02/skos/core#definition> "The recipient"^^xsd:string ;
+	<http://www.w3.org/2004/02/skos/core#prefLabel> "Getter"^^xsd:string ;
+	.
+
+gist:giver
+	a owl:ObjectProperty ;
+	rdfs:subPropertyOf gist:hasParticipant ;
+	owl:deprecated "true"^^xsd:boolean ;
+	<http://www.w3.org/2004/02/skos/core#definition> "The active party, the one with the obligation or the one initiating the transfer"^^xsd:string ;
+	<http://www.w3.org/2004/02/skos/core#prefLabel> "Giver"^^xsd:string ;
+	.
+
 gist:hasA
 	a
 		owl:InverseFunctionalProperty ,