Skip to content

Commit 0fd9ea9

Browse files
authored
Merge pull request #942 from semanticarts/release/12.0.1
Release 12.0.1 (into `master`)
2 parents 06b97ba + 07cd526 commit 0fd9ea9

File tree

6 files changed

+52
-22
lines changed

6 files changed

+52
-22
lines changed

README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,13 +5,13 @@ About gist
55

66
gist is Semantic Arts' minimalist upper ontology for the enterprise. It is designed to have the maximum coverage of typical business ontology concepts with the fewest number of primitives and the least amount of ambiguity.
77

8-
We have an active governance and best practices community around gist called the gist Council, with a teleconference on the first Thursday of every month, where practitioners and users of gist come together to discuss how to use gist and make suggestions on its evolution. Please send email to [GistCouncil@semanticarts.com](mailto:GistCouncil@semanticarts.com) if you would like to become involved.
8+
We maintain an active gist community forum where developers and users of gist come together to discuss the gist model, implementation best practices, and the evolution of gist. Meetings occur virtually on the first Thursday of every other month, starting in January. Please send email to [GistForum@semanticarts.com](mailto:GistForum@semanticarts.com) if you would like to become involved.
99

1010
You can also contribute to gist by adding your comments to [issue discussion threads](https://github.com/semanticarts/gist/issues) and submitting new issues and pull requests (see [guidelines for contributions](https://github.com/semanticarts/gist/blob/master/docs/Contributing.md)). You can view [minutes](https://github.com/semanticarts/gist/wiki/gist-Development-Team-Meeting-Notes) from our bi-monthly review sessions to find out what we've been discussing and get a preview of upcoming changes to gist.
1111

1212
gist is free and open to the public under the [Creative Commons 3.0](http://creativecommons.org/licenses/by-sa/3.0/) attribution share-alike license. In addition to the conditions of this license, we require that any concepts used from gist remain in the gist namespace, and that you do not define your own term definitions in the gist namespace.
1313

14-
For more information on gist and to download previously released versions of gist, see the [Semantic Arts website](https://www.semanticarts.com/gist).
14+
For more information on gist and to download the current or previous versions of gist, see the [Semantic Arts website](https://www.semanticarts.com/gist).
1515

1616
Documentation
1717
-----

bundle.yaml

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -94,7 +94,10 @@ actions:
9494
from: "(.*)\\.ttl"
9595
to: "\\g<1>{version}.ttl"
9696
includes:
97-
- "*.ttl"
97+
- gistCore.ttl
98+
- gistMediaTypes.ttl
99+
- gistPrefixDeclarations.ttl
100+
- gistSubClassAssertions.ttl
98101
- action: "definedBy"
99102
message: "Adding rdfs:isDefinedBy."
100103
source: "{output}"

docs/Namespace.md

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -17,8 +17,8 @@ available, that cover extensions to this core, both horizontally (HR and
1717
Accounting) and vertically (Professional Services, Healthcare). These
1818
other ontologies have different names but share the gist namespace.
1919

20-
If youre wondering why the namespace isnt the same as the ontology IRI,
21-
and therefore why it didnt return the ontology, read on.
20+
If you're wondering why the namespace isn't the same as the ontology IRI,
21+
and therefore why it didn't return the ontology, read on.
2222

2323
The Difference Between Namespaces and Ontologies
2424
-----
@@ -30,7 +30,7 @@ historically contained in a file.
3030

3131
The reason these two terms are so often conflated is that most ontology
3232
editing tools will provide both as a convenient default and will make both
33-
the same. When youre just screwing around learning ontology authoring
33+
the same. When you're just screwing around learning ontology authoring
3434
and building toy apps, this collapsing of the two terms is mostly benign.
3535

3636
It turns out that applying this default behavior to production systems is
@@ -57,7 +57,7 @@ you meant the default, which by default is the name of the ontology
5757
itself. This is the root of the confusion.
5858

5959
We advocate not using a default namespace. Much better to be explicit,
60-
and as well see, explicitness encourages (or at least doesnt obscure)
60+
and as we'll see, explicitness encourages (or at least doesn't obscure)
6161
reusing other terms that may have been minted elsewhere.
6262

6363
Minting IRIs
@@ -66,8 +66,8 @@ Minting IRIs
6666
The person or system that first defines a term or creates an identifier
6767
for a real world instance is said to have "minted" the identifier. It
6868
mints it within a namespace. It should be a namespace you have
69-
control over. Minting an IRI in someone elses namespace is called
70-
"namespace squatting." Not only is it poor form, it doesnt really
69+
control over. Minting an IRI in someone else's namespace is called
70+
"namespace squatting." Not only is it poor form, it doesn't really
7171
accomplish anything. If you decide to mint an IRI in the gist
7272
namespace, no one else will know this happened. You will be shouting
7373
in a well.
@@ -85,7 +85,7 @@ This is essentially a path within the domain name `w3id.org`, whose owners
8585
have given us exclusive control over. When we mint new terms, we will do so
8686
in this namespace.
8787

88-
An ontology neednt have any IRIs minted it its "own" namespace
88+
An ontology needn't have any IRIs minted it its "own" namespace
8989
-----
9090

9191
To cement the idea that the ontology need not have a 1:1 coorespondence to
@@ -106,15 +106,15 @@ its namespace, consider the following legitimate ontology.
106106
```
107107

108108
The first 8 lines declare namespace prefixes. Strictly speaking they are
109-
just conveniences (abbreviations), so that line 11 doesnt get too long
109+
just conveniences (abbreviations), so that line 11 doesn't get too long
110110
to read. The name of the ontology is in line 10. The entire ontology is
111-
in line 11, and doesnt refer to anything that was minted in this ontology.
111+
in line 11, and doesn't refer to anything that was minted in this ontology.
112112
It just says that someone named mccomb (as per the Semantic Arts
113-
namespace) owns (as per gists definition of ownership) something
113+
namespace) owns (as per gist's definition of ownership) something
114114
that dbPedia will soon recognize as Semantic Arts.
115115

116116
This ontology does not have any IRIs minted in either its namespace
117-
(which isnt even declared; I took out the default declaration) or
117+
(which isn't even declared; I took out the default declaration) or
118118
in this ontology.
119119

120120
How to partition
@@ -141,15 +141,15 @@ with the other two.
141141
Governance drives namespace use
142142
-----
143143

144-
But just because youve divided your ontology into partitions (modules)
145-
doesnt mean the namespaces must follow. In the above example, if one
144+
But just because you've divided your ontology into partitions (modules)
145+
doesn't mean the namespaces must follow. In the above example, if one
146146
group were doing all the ontology work for vendor, material and purchasing,
147147
they could easily do all three in the same namespace.
148148

149149
You really only need separate namespaces if you have people minting
150150
terms that are not coordinating with each other. If you have one group
151151
minting the term: `Account` to mean what accountants think and the
152-
sales group minting the term `Account` to mean prospect, youd have
152+
sales group minting the term `Account` to mean prospect, you'd have
153153
a difficult time with the accidental term collisions.
154154

155155
The solution is either to coordinate, or to have separate namespaces.
@@ -173,7 +173,7 @@ The problems become more obvious the more files you have. If someone
173173
mints a term, say a property or a class, in a sub-ontology that everyone
174174
agrees would be useful to have in other sub-ontologies, the other
175175
sub-ontologies can either import the one with the term they want
176-
(getting a bunch of axioms they dont want) or they can lobby for
176+
(getting a bunch of axioms they don't want) or they can lobby for
177177
promoting the term to a higher level ontology where it can be reused
178178
more easily. The only problem is that with that promotion, because
179179
each ontology has its own namespace, the name of the term must be

docs/ReleaseNotes.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,23 @@
11
gist Release Notes
22
=====
33

4+
Release 12.0.1
5+
-----
6+
7+
### Patch Updates
8+
9+
- Added missing `owl:Thing` assertions to gist instances to ensure that `rdfs:isDefinedBy` assertions are generated during the release bundling process. Issue [#775](https://github.com/semanticarts/gist/issues/775).
10+
11+
- Updated description of gist Forum in README. Issue [#917](https://github.com/semanticarts/gist/issues/917).
12+
13+
- Changed smart single quotes to straight quotes for the apostrophes in `docs/Namespace.md`. Issue [#919](https://github.com/semanticarts/gist/issues/919).
14+
15+
- Updated `bundle.yaml` to exclude the `gistValidationAnnotations` ontology from the release package. Issue [#922](https://github.com/semanticarts/gist/issues/922).
16+
17+
- Updated the Python HTML renderer to fix errors in display of gist documentation in the browser. Issue [#923](https://github.com/semanticarts/gist/issues/923).
18+
19+
Import URL: <https://w3id.org/semanticarts/ontology/gistCore12.0.1>.
20+
421
Release 12.0.0
522
-----
623

@@ -15,6 +32,7 @@ This is a major release which includes several changes which break compatibility
1532
- For each pair of inverses, the property deemed clearest, simplest, and/or most useful was retained.
1633
- Axioms referring to the deleted properties were reformulated using `owl:inverseOf`.
1734
- Breakdown:
35+
1836
| Properties retained in gist | Inverse properties removed from gist |
1937
| ----------- | ----------- |
2038
`hasDirectPart` | `isDirectPartOf`

gistCore.ttl

Lines changed: 12 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2608,7 +2608,10 @@ gist:_candela
26082608
.
26092609

26102610
gist:_day
2611-
a gist:DurationUnit ;
2611+
a
2612+
owl:Thing ,
2613+
gist:DurationUnit
2614+
;
26122615
skos:definition "A duration unit that is 24 hours long."^^xsd:string ;
26132616
skos:prefLabel "day"^^xsd:string ;
26142617
gist:conversionFactor "86400.0"^^xsd:double ;
@@ -2664,7 +2667,10 @@ gist:_meter
26642667
.
26652668

26662669
gist:_millisecond
2667-
a gist:DurationUnit ;
2670+
a
2671+
owl:Thing ,
2672+
gist:DurationUnit
2673+
;
26682674
skos:definition "A unit equal to a thousandth of a second."^^xsd:string ;
26692675
skos:prefLabel "millisecond"^^xsd:string ;
26702676
gist:conversionFactor "0.001"^^xsd:double ;
@@ -2673,7 +2679,10 @@ gist:_millisecond
26732679
.
26742680

26752681
gist:_minute
2676-
a gist:DurationUnit ;
2682+
a
2683+
owl:Thing ,
2684+
gist:DurationUnit
2685+
;
26772686
skos:definition "A unit equal to 60 seconds."^^xsd:string ;
26782687
skos:prefLabel "minute"^^xsd:string ;
26792688
gist:conversionFactor "60.0"^^xsd:double ;

gistSubClassAssertions.ttl

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@
1212
owl:imports <https://w3id.org/semanticarts/ontology/gistCore> ;
1313
skos:definition "Supplementary subclass assertions for gistCore."^^xsd:string ;
1414
skos:prefLabel "gist Subclass Assertions"^^xsd:string ;
15-
skos:scopeNote "This ontology contains supplementary subclass assertions that are logically entailed by gistCore but are not inferred by some automated reasoners. For example, an OWL RL reasoner would not infer that gist:Commitment is a subclass of gist:Intention, even though it follows from the ontology axioms. More precisely, it contains (1) subclass assertions derived using an OWL DL reasoner and (2) the subclass assertions that are already explicit in gistCore."^^xsd:string ;
15+
skos:scopeNote "This ontology contains supplementary subclass assertions that are logically entailed by gistCore but are not inferred by some automated reasoners. For example, an OWL RL reasoner would not infer that gist:Commitment is a subclass of gist:Intention, although it follows from the ontology axioms. More precisely, it contains (1) subclass assertions derived using an OWL DL reasoner and (2) the subclass assertions that are already explicit in gistCore."^^xsd:string ;
1616
gist:license "https://creativecommons.org/licenses/by-sa/3.0/"^^xsd:string ;
1717
.
1818

0 commit comments

Comments
 (0)