From af74b7c10c03632280954e439167d4be1fc31906 Mon Sep 17 00:00:00 2001 From: pwin <1072204+pwin@users.noreply.github.com> Date: Tue, 12 Aug 2025 19:00:10 +0100 Subject: [PATCH 1/3] issue 1234, update scope note on gist:description --- ontologies/gistCore.ttl | 14 +++++++++----- 1 file changed, 9 insertions(+), 5 deletions(-) diff --git a/ontologies/gistCore.ttl b/ontologies/gistCore.ttl index 9c9866e3..feb3e9d3 100644 --- a/ontologies/gistCore.ttl +++ b/ontologies/gistCore.ttl @@ -2,7 +2,7 @@ @prefix gistd: . @prefix owl: . @prefix rdf: . -@prefix rdfs: . +@prefix rdfs: . @prefix skos: . @prefix xml: . @prefix xsd: . @@ -1417,11 +1417,13 @@ gist:Organization gist:SchemaMetaData , gist:UnitOfMeasure ; -skos:definition "A structured entity formed to achieve specific goals, typically involving members with defined roles."^^xsd:string ; -skos:scopeNote "Not all organizations have members, e.g. shell companies."^^xsd:string ; + skos:definition "A structured entity formed to achieve specific goals, typically involving members with defined roles."^^xsd:string ; skos:example "Legal entities like companies; non-legal entities like clubs, committees, or departments."^^xsd:string ; skos:prefLabel "Organization"^^xsd:string ; - skos:scopeNote "While typically the members of organizations are people, in some cases they are other organizations; e.g., the members of the United Nations are country governments."^^xsd:string ; + skos:scopeNote + "Not all organizations have members, e.g. shell companies."^^xsd:string , + "While typically the members of organizations are people, in some cases they are other organizations; e.g., the members of the United Nations are country governments."^^xsd:string + ; . gist:Permission @@ -2332,7 +2334,9 @@ gist:description skos:definition "A statement about someone or something's attributes or characteristics."^^xsd:string ; skos:example "The Empire State Building is a 102-story Art Deco skyscraper in Midtown Manhattan in New York City, United States. It was designed by Shreve, Lamb & Harmon and built from 1930 to 1931."^^xsd:string ; skos:prefLabel "description"^^xsd:string ; - skos:scopeNote "This property is used to provide a description of an individual in greater detail than a label."^^xsd:string ; + skos:scopeNote """This property is to be used to describe data individuals which are not part of the ontology subject matter. + A definition and a description have different semantics.Use skos:definition when it is 'a statement of the exact meaning of a thing', + and gist:description when it is a representation or account of a thing, but not a statement of meaning."""^^xsd:string ; . gist:domainIncludes From c68ccf892cde71e3c7f428d999730f2981112b60 Mon Sep 17 00:00:00 2001 From: pwin <1072204+pwin@users.noreply.github.com> Date: Wed, 13 Aug 2025 08:43:20 +0100 Subject: [PATCH 2/3] Update ontologies/gistCore.ttl Co-authored-by: Jamie-SA <45212760+Jamie-SA@users.noreply.github.com> --- ontologies/gistCore.ttl | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ontologies/gistCore.ttl b/ontologies/gistCore.ttl index feb3e9d3..8ea35667 100644 --- a/ontologies/gistCore.ttl +++ b/ontologies/gistCore.ttl @@ -2335,7 +2335,7 @@ gist:description skos:example "The Empire State Building is a 102-story Art Deco skyscraper in Midtown Manhattan in New York City, United States. It was designed by Shreve, Lamb & Harmon and built from 1930 to 1931."^^xsd:string ; skos:prefLabel "description"^^xsd:string ; skos:scopeNote """This property is to be used to describe data individuals which are not part of the ontology subject matter. - A definition and a description have different semantics.Use skos:definition when it is 'a statement of the exact meaning of a thing', + A definition and a description have different semantics. Use skos:definition when it is 'a statement of the exact meaning of a thing', and gist:description when it is a representation or account of a thing, but not a statement of meaning."""^^xsd:string ; . From f7a7b57705d36a06da304c0fd997b6e7e500eade Mon Sep 17 00:00:00 2001 From: pwin <1072204+pwin@users.noreply.github.com> Date: Thu, 14 Aug 2025 13:50:20 +0100 Subject: [PATCH 3/3] added release note --- docs/release_notes/issue1234-add-scope-note-to-description.md | 3 +++ 1 file changed, 3 insertions(+) create mode 100644 docs/release_notes/issue1234-add-scope-note-to-description.md diff --git a/docs/release_notes/issue1234-add-scope-note-to-description.md b/docs/release_notes/issue1234-add-scope-note-to-description.md new file mode 100644 index 00000000..655ee1e7 --- /dev/null +++ b/docs/release_notes/issue1234-add-scope-note-to-description.md @@ -0,0 +1,3 @@ +### Minor Updates + +- Added a clearer scope note to `gist:description`. Issue [#1234](https://github.com/semanticarts/gist/issues/1234). \ No newline at end of file