Merge branch 'main' into develop

Author: dgarijo

README.md

@@ -56,33 +56,19 @@ interface type. All proposed classes extend `schema:SoftwareApplication`.
 
 ### Executable name
 
-The name of the executable within a certain run-time context (e.g. an
-executable filename or name of an importable module). This documents on a
-fairly high level by what name software is invoked from a certain run-time
-context. The run-time context itself is turn loosely determined by properties
-such as ``schema:runtimePlatform`` and ``schema:operatingSystem``.
+The base filename of the executable for the software application. It should not
+be a full path, nor should it contain any command-line parameters.
 
 We include this property to make a clear distinction between the human readable
-name of the software, and the identifier used in invocation of the software.
+name of the software, and the executable used in invocation of the software.
 The two may regularly differ with one being more verbose or have stricter
 casing than the other.
 
-Examples for this property are:
-
-* The name of the invoked executable as invoked from the command line
-* The name of the library as used in the linking stage for compiled languages
-* The highest-level name of the module as invoked in an ``import`` or ``include`` statement in languages such as Python, R, Perl, Java.
-* The name of the package as passed to a certain package manager (for ``SoftwarePackage``)
-* The name of the container as known to a certain container registry (for ``SoftwareImage``)
-
 Examples of this property are also shown in the code snippets A and B. 
 
-Note that the executable name should typically not contain any
-platform/runtime-specific extensions which may differ across systems
-(``.exe``,``.so``,``.dll``,``.dylib``). However, such extensions may be
-included if they are static over all possible systems and needed to invoke the
-software (``.jar``,``.sh``) and a necessary component in invoking the software
-from a specific context.
+It's recommended to either leave out any platform-specific extensions like
+``.exe`` if the executable differs across platforms, or to simply use the
+property multiple times to list all possible variants.
 
 ## How are software types terms used with codemeta?
 
@@ -118,7 +104,6 @@ Example A (JSON-LD): An application named [WIDOCO](https://github.com/dgarijo/Wi
         },
         {
             "type": "SoftwareLibrary",
-            "executableName": "es.oeg.Widoco",
             "name": "WIDOCO",
             "runtimePlatform": "Linux"
         },
@@ -204,6 +189,16 @@ implemented in the following software:
 
 Many vocabularies exist to describe software or its constituent parts, e.g., the [software description ontology](https://w3id.org/okn/o/sd/), [description of a project vocabulary](http://usefulinc.com/ns/doap#), [hydra](https://www.hydra-cg.com/spec/latest/core/) (for API description), the common workflow language (description of inputs and outputs of software components, etc.), etc.  Our proposed profile does not aim to redefine any new term related to software, but propose a lightweight profile that can be easily incorporated into schema.org or codemeta.
 
+## Real Examples
+
+You can consult the following projects as examples that make use of this profile:
+
+* [frog](https://github.com/LanguageMachines/frog/blob/master/codemeta.json)
+* [ucto](https://github.com/LanguageMachines/ucto/blob/master/codemeta.json)
+* [libfolia](https://github.com/LanguageMachines/libfolia/blob/master/codemeta.json)
+
+Furthermore, the [CLARIAH Tools Portal](https://tools.dev.clariah.nl/) is build on the aforementioned implementations and may offer further examples of codemeta that also incorporates this software application type profile.
+
 ## Acknowledgement
 
 This work was indirectly and partially funded through the [CLARIAH-PLUS project](https://clariah.nl).

software-types.jsonld

@@ -8,6 +8,7 @@
         "DesktopApplication": { "@id": "stype:DesktopApplication" },
         "TerminalApplication": { "@id": "stype:TerminalApplication" },
         "ServerApplication": { "@id": "stype:ServerApplication" },
+        "SoftwareLibrary": { "@id": "stype:SoftwareLibrary" },
         "SoftwareImage": { "@id": "stype:SoftwareImage" },
         "SoftwarePackage": { "@id": "stype:SoftwarePackage" },
         "NotebookApplication": { "@id": "stype:NotebookApplication" },
@@ -83,7 +84,7 @@
             "@id": "stype:executableName",
             "@type": "Property",
             "label": "Executable Name",
-            "comment": "The name of the executable within a certain run-time context (e.g. an executable filename or name of an importable module)."
+            "comment": "Filename of the executable for the software application."
         }
     ]
 }

software-types.ttl

@@ -1,6 +1,7 @@
 @prefix : <https://schema.org/> .
 @prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
 @prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
+@prefix owl: <http://www.w3.org/2002/07/owl#> .
 @prefix xml: <http://www.w3.org/XML/1998/namespace> .
 @prefix xsd: <http://www.w3.org/2001/XMLSchema#> .
 @prefix stype: <https://w3id.org/software-types#> .
@@ -10,22 +11,21 @@
 # and are eventually proposed upstream to schema.org (but that may take a while)
 
 #metadata
-stype: rdf:type owl:Ontology ;
-                            owl:versionIRI <https://w3id.org/stype/1.0.0> ;
-                            <http://purl.org/dc/terms/abstract> "This profile describes vocabulary terms for specifying software application types, used for software metadata descriptions."@en ;
-                            <http://purl.org/dc/elements/1.1/description> "This profile describes vocabulary terms for specifying software application types, used for software metadata descriptions."@en ;
+<https://w3id.org/software-types> rdf:type owl:Ontology ;
+                            owl:versionIRI <https://w3id.org/software-types/1.0.0> ;
+                            <http://purl.org/dc/terms/abstract> "This profile describes vocabulary terms needed to describe the metadata of software application types (e.g., command line, desktop, software package, software library, etc.)"@en ;
+                            <http://purl.org/dc/elements/1.1/description> "This profile describes vocabulary terms needed to describe the metadata of software application types (e.g., command line, desktop, software package, software library, etc.)"@en ;
                             <http://purl.org/dc/elements/1.1/title> "The Software Types ontology"@en ;
                             <http://purl.org/dc/terms/created> "February 3rd, 2022"@en ;
                             <http://purl.org/dc/terms/creator> "Maarten van Gompel"@en ,
                                                                "Daniel Garijo"@en ;
                             <http://purl.org/dc/terms/license> <http://creativecommons.org/licenses/by/2.0/> ;
                             <http://purl.org/vocab/vann/preferredNamespacePrefix> "stype"@en ;
-                            <http://purl.org/vocab/vann/preferredNamespaceUri> "https://w3id.org/software-types#" ;
-                            <http://schema.org/citation> "Cite this vocabulary as: van Gompel, M and Garijo, D. The Software Input/Output Data ontology 1.0.0."@en ;
-                            rdfs:comment "This profile describes vocabulary terms for specifying software application types, used for software metadata descriptions."@en ;
+                            <http://purl.org/vocab/vann/preferredNamespaceUri> "https://w3id.org/software-types" ;
+                            <http://schema.org/citation> "Cite this vocabulary as: van Gompel, M and Garijo, D. The Software Types ontology 1.0.0."@en ;
+                            rdfs:comment "This profile describes vocabulary terms needed to describe the metadata of software application types (e.g., command line, desktop, software package, software library, etc.)"@en ;
                             owl:versionInfo "1.0.0"@en .
 
-
 stype:CommandLineApplication a rdfs:Class ;
     rdfs:label "Command-Line Application" ;
     :source <https://github.com/codemeta/codemeta/issues/271> ;
@@ -35,7 +35,7 @@ stype:CommandLineApplication a rdfs:Class ;
 stype:DesktopApplication a rdfs:Class ;
     rdfs:label "Desktop Application" ;
     :source <https://github.com/codemeta/codemeta/issues/271> ;
-    rdfs:comment "A software application offering a desktop graphical user interface." ;
+    rdfs:comment "A software application offering a graphical user interface on the deskop." ;
     rdfs:subClassOf :SoftwareApplication .
 
 stype:TerminalApplication a rdfs:Class ;
@@ -81,7 +81,7 @@ stype:executableName a rdf:Property ;
     :domainIncludes :SoftwareApplication , :SoftwareSourceCode ;
     :rangeIncludes :Text ;
     :source <https://github.com/codemeta/codemeta/issues/271> ;
-    rdfs:comment "The name of the executable within a certain run-time context (e.g. an executable filename or name of an importable module)." .
+    rdfs:comment: "Filename of the executable for the software application" .
 
 # the following already exist, but are extended: