Release 9.6.0

Author: sa-bpelakh

.gitignore

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

bundle.yaml

@@ -5,6 +5,7 @@ variables:
   input: "."
   rdf-toolkit: "{input}/tools/rdf-toolkit.jar"
   output: "{name}{version}_webDownload"
+  validation: "validation"
 tools:
 - name: "serializer"
   type: "Java"
@@ -55,9 +56,25 @@ tools:
     - "-t"
     - "{outputFile}"
 actions:
+# Create validation directory
+- action: "mkdir"
+  directory: "{validation}"
+# Validate ontology
+- action: "verify"
+  message: "Validating ontology via SHACL."
+  type: "shacl"
+  inference: "none"
+  target: "{validation}/ontologyValidationReport.ttl"
+  source: "{input}"
+  includes:
+    - gistCore.ttl
+    - gistValidationAnnotations.ttl
+  shapes:
+    source: "{input}/ontologyShapes.ttl"
 - action: "mkdir"
   directory: "{output}"
 - action: "copy"
+  message: "Substituting version numbers."
   source: "{input}"
   target: "{output}"
   replace:
@@ -69,17 +86,20 @@ actions:
   includes:
     - "*.ttl"
 - action: "definedBy"
+  message: "Adding rdfs:definedBy."
   source: "{output}"
   target: "{output}"
   includes:
     - "*.ttl"
 - action: "transform"
+  message: "Turtle serialization."
   tool: "serializer"
   source: "{output}"
   target: "{output}"
   includes:
     - "*.ttl"
 - action: "transform"
+  message: "RDF/XML serialization."
   tool: "xml-serializer"
   source: "{output}"
   target: "{output}"
@@ -89,6 +109,7 @@ actions:
   includes:
     - "*.ttl"
 - action: "transform"
+  message: "JSON/LD serialization."
   tool: "json-serializer"
   source: "{output}"
   target: "{output}"
@@ -98,6 +119,7 @@ actions:
   includes:
     - "*.ttl"
 - action: "sparql"
+  message: "Generating rdfs:label for backward compatibility."
   source: "{output}"
   target: "{output}/rdfsAnnotations.ttl"
   format: "turtle"
@@ -130,6 +152,7 @@ actions:
   source: "{output}/rdfsAnnotations.ttl"
   target: "{output}/rdfsAnnotations.ttl"
 - action: "copy"
+  message: "Copying license text."
   source: "{input}/LICENSE.txt"
   target: "{output}"
 - action: "copy"
@@ -138,9 +161,11 @@ actions:
   includes:
     - "ReleaseNotes.md"
 - action: "markdown"
+  message: "Formatting release notes."
   source: "{input}/docs/ReleaseNotes.md"
   target: "{output}/Documentation/ReleaseNotes.html"
 - action: "move"
+  message: "Creating Deprecated folder."
   source: "{output}"
   target: "{output}/Deprecated"
   includes:

docs/Contributing.md

@@ -124,7 +124,7 @@ Pull Requests
 - Some ontologists are repository admins with permission to merge to the "develop" branch. If your reviewer is not one of these, he/she will re-assign the PR to one of them after approving it for merge.
 - Squash merges will not be used; however, the admin may choose to perform a rebase on the branch being merged in order to clean up the commit history.
 - The GitHub project board is configured to automatically move a merged PR and its associated issue(s) to the Done column.
-- The repository is configured to automatically delete the implementation branch from the remote; those with local copies of this branch should delete them locally.
+- The person performing the merge should delete the merged branch on the remote.
 
 ### Multi-Developer Projects
 

docs/ReleaseNotes.md

@@ -1,14 +1,43 @@
 gist Release Notes
 =====
 
+Release 9.6.0
+-----
+
+### Minor Updates
+
+- Added datatype property `gist:description` for describing instance data. Issue [#425](https://github.com/semanticarts/gist/issues/425).
+- 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 `giver` and `getter`
+    - 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 all `skos:prefLabel` values based on a newly-adopted convention. See the convention specification in
+  the section on Labels in the [gist style guide](https://github.com/semanticarts/gist/blob/v9.5.0/docs/gistStyleGuide.md#Labels).
+  Added `skos:prefLabel` validation to build process for classes and properties.
+  Issues [#227](https://github.com/semanticarts/gist/issues/227) and
+  [#421](https://github.com/semanticarts/gist/issues/421).
+
+Import URL: <https://ontologies.semanticarts.com/o/gistCore9.6.0>.
+
 Release 9.5.0
 -----
 
 ### Minor Updates
 
-- Converted RDFS annotations to SKOS annotations. See [gist style guide](gistStyleGuide.md) for usage details. A file containing legacy RDFS annotations is included in the release package for those who wish to continue using them for existing terms. Issues [#351](https://github.com/semanticarts/gist/issues/351), [#379](https://github.com/semanticarts/gist/issues/379).
+- Converted RDFS annotations to SKOS annotations. See [gist style guide](https://github.com/semanticarts/gist/blob/v9.5.0/docs/gistStyleGuide.md) for usage details. A file containing legacy RDFS annotations is included in the release package for those who wish to continue using them for existing terms. Issues [#351](https://github.com/semanticarts/gist/issues/351), [#379](https://github.com/semanticarts/gist/issues/379).
 - Deprecated `gist:geoDirectlyContains` and `gist:geoDirectlyContainedIn`. Issue [#328](https://github.com/semanticarts/gist/issues/328).
 - Removed `gist:Address` from range of `gist:toAgent` and `gist:fromAgent`. Issue [#391](https://github.com/semanticarts/gist/issues/391).
+- Added label validation rules for classes and properties. Created `gist:nonCoformingLabel` annotation property to tag exceptions to the rule. Issue [#227](https://github.com/semanticarts/gist/issues/227).
 
 ### Patch Updates
 
@@ -19,6 +48,7 @@ Release 9.5.0
 - Added a standard `pre-commit` hook which applies uniform formatting to RDF files using `tools/rdf-toolkit.jar`. Issue [#228](https://github.com/semanticarts/gist/issues/228).
 - Conformed definition of `gist:_second` to other `gist:BaseUnit` individuals. Issue [#92](https://github.com/semanticarts/gist/issues/92).
 - Fixed label of TaskTemplate. Issue [#407](https://github.com/semanticarts/gist/issues/407).
+- Corrected all class and property labels to be compliant with validation rules documented in the [gist style guide](https://github.com/semanticarts/gist/blob/v9.5.0/docs/gistStyleGuide.md). Issue [#227](https://github.com/semanticarts/gist/issues/227).
 
 Import URL: <https://ontologies.semanticarts.com/o/gistCore9.5.0>.
 

docs/gistStyleGuide.md

@@ -48,20 +48,36 @@ Naming
 
 ### Labels
 
+The following conventions apply to `skos:prefLabel` but not `skos:altLabel`.
+
 #### Classes
 
-- Sentence case
+- Title case (see definition of title case below)
 - Normalized to natural language standards. E.g., hyphens inserted, acronyms in all caps, etc.
-  - Examples: _AMA guideline_, _ISBN-10_
+  - Examples: _AMA Guideline_, _ISBN-10_
 
 #### Properties
 
-- Same as classes, but initial lowercase
-- Examples: _has unit of measure_, _has SSN_.
+- Lower case
+- Normalized to natural language standards. E.g., hyphens inserted, acronyms in all caps, proper nouns capitalized, etc.
+- Examples: _has unit of measure_, _has SSN_, _unit symbol Unicode_
 
-#### Rationale
+#### gist Definition of Title Case
+
+The rules of title case are not universally standardized; standardization is only at the level of house styles and individual style guides. Most English style guides agree that the first and last words should always be capitalized, while articles, short prepositions, and some conjunctions should not be. Other rules about the capitalization vary.
+
+gist style guide for title case:
 
-We adopt sentence over title case because the latter, while technically well-defined, has more complex rules and can introduce inconsistencies when implemented by different users.
+- Capitalize:
+  - First and last words
+  - Words of four or more letters (e.g., _Between_, _With_)
+  - Second part of hyphenated word (e.g., _Data-Centric_ not _Data-centric_)
+- Lowercase:
+  - Articles: *a*, *an*, *the*
+  - Conjunctions: *and*, *but*, *if*, *for*, *or*, *nor*, *so*, *yet*
+  - Prepositions: *as*, *at*, *by*, *cum*, *ere*, *for*, *in*, *of*, *off*, *on*, *out*, *per*, *pre*, *pro*, *qua*, *re*, *sub*, *to*, *up*, *via*
+- Acronyms in all caps (e.g., _SSN_, _ISBN_)
+- Capitalize everything else
 
 ### Annotations
 
@@ -93,7 +109,7 @@ Certain RDFS annotations are recommended where there is no SKOS equivalent.
 | ---------: | ------- |
 | `skos:changeNote` | Normally change notes are provided by the git history or version comparison. |
 | `skos:historyNote` | Normally change notes are provided by the git history or version comparison. |
-| `skos:note` | A more specific annotation is preferred. |
+| `skos:note` | Use a more specific annotation whenever possible. |
 
 *Do not use*
 | Annotation | Instead Use |