From 569485975598e62617bba03fdc15aac4003d6a03 Mon Sep 17 00:00:00 2001 From: Rebecca Younes Date: Thu, 12 Jun 2025 14:02:34 -0400 Subject: [PATCH 1/4] Update definition and scope note of gist:Organization --- ontologies/gistCore.ttl | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/ontologies/gistCore.ttl b/ontologies/gistCore.ttl index a215883a..cfc54ea2 100644 --- a/ontologies/gistCore.ttl +++ b/ontologies/gistCore.ttl @@ -1418,10 +1418,10 @@ gist:Organization gist:SchemaMetaData , gist:UnitOfMeasure ; - skos:definition "A generic organization that can be formal or informal, legal or non-legal. It can have members, or not."^^xsd:string ; + skos:definition "An organized body of individuals with a particular purpose, often with a structured approach and 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 "There are a plethora of different kinds of organizations that differ along many facets, including members, structure, purpose, legal vs. non-legal, etc."^^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 ; . gist:Permission From 912c799383d5daec2fa70517ca3b1f22316e229d Mon Sep 17 00:00:00 2001 From: Rebecca Younes Date: Thu, 12 Jun 2025 14:18:17 -0400 Subject: [PATCH 2/4] Fix link to latest gist download in README --- README.md | 15 +++++++++------ docs/Contributing.md | 5 ++--- docs/release_notes/issue1184-readme-fixes.md | 3 +++ 3 files changed, 14 insertions(+), 9 deletions(-) create mode 100644 docs/release_notes/issue1184-readme-fixes.md diff --git a/README.md b/README.md index f287b04c..b052ea96 100644 --- a/README.md +++ b/README.md @@ -10,26 +10,29 @@ You can also contribute to gist by adding your comments to [issue discussion thr gist is free and open to the public under the [Creative Commons Attribution 4.0 International](https://creativecommons.org/licenses/by/4.0/) 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. -[Download the latest version of gist](https://w3id.org/semanticarts/ontology/gistCore). +To get gist: +- Download the [latest released version of gist](https://w3id.org/semanticarts/ontology/gistCore_Latest_Download.zip). +- Import into Protégé with the link: https://w3id.org/semanticarts/ontology/gistCore. +- Clone or download gist from the [GitHub repository](https://github.com/semanticarts/gist/). For more information on gist and to download previous versions, see the [Semantic Arts website](https://www.semanticarts.com/gist). -## Documentation +# Documentation We provide a number of resources for learning more about gist. -### The gist-doc Repository +## The gist-doc Repository Extensive documentation of gist is available in the [gist-doc repository](https://github.com/semanticarts/gist-doc). This repository contains documentation of the [Semantic Arts gist minimalist upper ontology](https://github.com/semanticarts/gist/tree/master) in three formats: narrative, graphical, and Widoco-style. * **gist Constellations (eBook)** - * The organization of the eBook is based around the idea of 'constellations' of classes and predicates that deal with related concepts. + * The organization of the eBook is based around the idea of 'constellations' of classes and predicates that deal with related concepts. * epub and mobi formats * **gist Constellations (visualizations)** * A collection of PNG images built using the [Turtle Editor Viewer](http://semantechs.co.uk/turtle-editor-viewer/). Each image is made up of a single 'constellation' of classes as described above and shows the classes and their relationships, the literal annotations, and any anonymous classes used in class definitions. * **[Widoco](https://github.com/dgarijo/Widoco) documentation** - -### Additional Documentation + +## Additional Documentation * **Videos:** We maintain a library of videos containing gist tutorials and recordings of our monthly gist Council meetings. You can find links to these videos on the [Semantic Arts website](https://www.semanticarts.com/gist/videos/), or directly access the entire catalog on [our YouTube channel](https://www.youtube.com/playlist?list=PLk2kJrehubb4dc3e5Db5Lvv9WMaOhV3V7). * The [Semantic Arts gist web page](https://www.semanticarts.com/gist/). diff --git a/docs/Contributing.md b/docs/Contributing.md index 4800e740..4ff06b6a 100644 --- a/docs/Contributing.md +++ b/docs/Contributing.md @@ -118,8 +118,7 @@ The pre-commit hook does several things when you run `git commit`: - Several small issues such as typo corrections, definition fixes, or documentation updates can be submitted in a single PR. - Issues that are tightly related can be addressed in a single PR. - The PR should address the entirety of an issue. If it does not, either the PR should be modified or the issue should be broken up into parts. -- The description of the PR should contain the keywords "Closes #nnn" (or another of the [GitHub keywords](https://docs.github.com/en/enterprise/2.21/user/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue#linking-a-pull-request-to-an-issue-using-a-keyword)) where nnn is the issue number. This automatically closes the related issue(s) when the PR is merged, and creates a link which allows readers and reviewers to easily reference the issue. - - Example: "Correct cardinality restriction on class gist:Room. Closes #98." +- The description of the PR should contain the keywords "Closes #nnn" where "nnn" is the issue number. This automatically closes the related issue(s) when the PR is merged, and creates a link which allows readers and reviewers to easily reference the issue. See [GitHub keywords](https://docs.github.com/en/enterprise/2.21/user/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue#linking-a-pull-request-to-an-issue-using-a-keyword). - Note that if the PR fixes multiple issues, each issue number must be prefixed by the keyword. E.g., "Closes #98, closes #102", rather than "Closes #98, #102" or "Closes #98 and #102". - The PR should include an update to the release notes. See [_Release Notes_](#release-notes). - Refer to the [_Deprecation and Deletion Policy_](DeprecationAndDeletionPolicy.md) if you are deprecating or deleting terms. @@ -176,7 +175,7 @@ The pre-commit hook does several things when you run `git commit`: - The name of the release note file has no significance, though it is helpful to name it according to the PR or issue number being addressed. - Reviewers will reject a PR without a well-formed release note. - Before building the release package, the release manager will review the release notes for content and formatting, revising as necessary; copy them into the [_ReleaseNotes.md_](ReleaseNotes) file, using sections for major, minor, and patch changes; and delete the individual files. - + #### Formatting - The final release notes will be divided into three sections, for major, minor, and patch changes, as relevant. diff --git a/docs/release_notes/issue1184-readme-fixes.md b/docs/release_notes/issue1184-readme-fixes.md new file mode 100644 index 00000000..7ef57356 --- /dev/null +++ b/docs/release_notes/issue1184-readme-fixes.md @@ -0,0 +1,3 @@ +### Patch Updates + +- Fixed link to gist download in the README. Issue [#1184](https://github.com/semanticarts/gist/issues/1184). From 10de9fbee9dc61048a7d2f1d8e50ef809a3afa5b Mon Sep 17 00:00:00 2001 From: Rebecca Younes Date: Fri, 27 Jun 2025 09:24:08 -0400 Subject: [PATCH 3/4] Fix headings in README --- README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index b052ea96..749fd9c8 100644 --- a/README.md +++ b/README.md @@ -17,11 +17,11 @@ To get gist: For more information on gist and to download previous versions, see the [Semantic Arts website](https://www.semanticarts.com/gist). -# Documentation +## Documentation We provide a number of resources for learning more about gist. -## The gist-doc Repository +### The gist-doc Repository Extensive documentation of gist is available in the [gist-doc repository](https://github.com/semanticarts/gist-doc). This repository contains documentation of the [Semantic Arts gist minimalist upper ontology](https://github.com/semanticarts/gist/tree/master) in three formats: narrative, graphical, and Widoco-style. @@ -32,7 +32,7 @@ Extensive documentation of gist is available in the [gist-doc repository](https: * A collection of PNG images built using the [Turtle Editor Viewer](http://semantechs.co.uk/turtle-editor-viewer/). Each image is made up of a single 'constellation' of classes as described above and shows the classes and their relationships, the literal annotations, and any anonymous classes used in class definitions. * **[Widoco](https://github.com/dgarijo/Widoco) documentation** -## Additional Documentation +### Additional Documentation * **Videos:** We maintain a library of videos containing gist tutorials and recordings of our monthly gist Council meetings. You can find links to these videos on the [Semantic Arts website](https://www.semanticarts.com/gist/videos/), or directly access the entire catalog on [our YouTube channel](https://www.youtube.com/playlist?list=PLk2kJrehubb4dc3e5Db5Lvv9WMaOhV3V7). * The [Semantic Arts gist web page](https://www.semanticarts.com/gist/). From ac86c91604d1b724846a1150485c4e1dfb15f35d Mon Sep 17 00:00:00 2001 From: Rebecca Younes Date: Thu, 23 Oct 2025 13:59:32 -0400 Subject: [PATCH 4/4] Change name of download file; fix markdown lint problems --- README.md | 21 +++++++++++---------- 1 file changed, 11 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index 749fd9c8..edeb3853 100644 --- a/README.md +++ b/README.md @@ -11,8 +11,9 @@ You can also contribute to gist by adding your comments to [issue discussion thr gist is free and open to the public under the [Creative Commons Attribution 4.0 International](https://creativecommons.org/licenses/by/4.0/) 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. To get gist: -- Download the [latest released version of gist](https://w3id.org/semanticarts/ontology/gistCore_Latest_Download.zip). -- Import into Protégé with the link: https://w3id.org/semanticarts/ontology/gistCore. + +- Download the [latest released version of gist](https://downloads.semanticarts.com/gistCore_Current_Version.zip) or from the zip file available on the [GitHub repository releases page](https://github.com/semanticarts/gist/releases). +- Import into Protégé with the link: . - Clone or download gist from the [GitHub repository](https://github.com/semanticarts/gist/). For more information on gist and to download previous versions, see the [Semantic Arts website](https://www.semanticarts.com/gist). @@ -25,14 +26,14 @@ We provide a number of resources for learning more about gist. Extensive documentation of gist is available in the [gist-doc repository](https://github.com/semanticarts/gist-doc). This repository contains documentation of the [Semantic Arts gist minimalist upper ontology](https://github.com/semanticarts/gist/tree/master) in three formats: narrative, graphical, and Widoco-style. -* **gist Constellations (eBook)** - * The organization of the eBook is based around the idea of 'constellations' of classes and predicates that deal with related concepts. - * epub and mobi formats -* **gist Constellations (visualizations)** - * A collection of PNG images built using the [Turtle Editor Viewer](http://semantechs.co.uk/turtle-editor-viewer/). Each image is made up of a single 'constellation' of classes as described above and shows the classes and their relationships, the literal annotations, and any anonymous classes used in class definitions. -* **[Widoco](https://github.com/dgarijo/Widoco) documentation** +- **gist Constellations (eBook)** + - The organization of the eBook is based around the idea of 'constellations' of classes and predicates that deal with related concepts. + - epub and mobi formats +- **gist Constellations (visualizations)** + - A collection of PNG images built using the [Turtle Editor Viewer](http://semantechs.co.uk/turtle-editor-viewer/). Each image is made up of a single 'constellation' of classes as described above and shows the classes and their relationships, the literal annotations, and any anonymous classes used in class definitions. +- **[Widoco](https://github.com/dgarijo/Widoco) documentation** ### Additional Documentation -* **Videos:** We maintain a library of videos containing gist tutorials and recordings of our monthly gist Council meetings. You can find links to these videos on the [Semantic Arts website](https://www.semanticarts.com/gist/videos/), or directly access the entire catalog on [our YouTube channel](https://www.youtube.com/playlist?list=PLk2kJrehubb4dc3e5Db5Lvv9WMaOhV3V7). -* The [Semantic Arts gist web page](https://www.semanticarts.com/gist/). +- **Videos:** We maintain a library of videos containing gist tutorials and recordings of our monthly gist Council meetings. You can find links to these videos on the [Semantic Arts website](https://www.semanticarts.com/gist/videos/), or directly access the entire catalog on [our YouTube channel](https://www.youtube.com/playlist?list=PLk2kJrehubb4dc3e5Db5Lvv9WMaOhV3V7). +- The [Semantic Arts gist web page](https://www.semanticarts.com/gist/).