Update 1.3-DRAFT with changes added to 1.2 after its release

docs/_specification/1.3-DRAFT/appendix/changelog.md

@@ -28,7 +28,7 @@ excerpt: List of changes in releases of this specifications
 
 # APPENDIX: Changelog {#changelog}
 
-* RO-Crate 1.2.0
+* [RO-Crate 1.2.0](https://github.com/ResearchObject/ro-crate/releases/tag/1.2.0) <https://w3id.org/ro/crate/1.2>
   * Clarified that the [RO-Crate Metadata Descriptor MUST have `@id` of `ro-crate-metadata.json`](../root-data-entity#ro-crate-metadata-descriptor) by removing conflicting statements elsewhere in the specification [#365](https://github.com/ResearchObject/ro-crate/pull/365)
   * Updated the Bioschemas namespace for properties from `https://bioschemas.org/ComputationalWorkflow#` to `https://bioschemas.org/properties/`. This change affects only the `input` and `output` properties in the [JSON-LD context](../ro-crate-metadata.json).
   * **Change**: Replaced [name-based algorithm for finding root](../root-data-entity#finding-the-root-data-entity)  [#198](https://github.com/ResearchObject/ro-crate/issues/198) [#365](https://github.com/ResearchObject/ro-crate/pull/365)
@@ -58,9 +58,6 @@ excerpt: List of changes in releases of this specifications
   * Clarified mandatory metadata for the Root Data Entity [#404](https://github.com/ResearchObject/ro-crate/pull/404)
   * Many sections reviewed to improve language and examples [#378](https://github.com/ResearchObject/ro-crate/pull/378) [#382](https://github.com/ResearchObject/ro-crate/pull/382) [#404](https://github.com/ResearchObject/ro-crate/pull/404) [#410](https://github.com/ResearchObject/ro-crate/pull/410) [#411](https://github.com/ResearchObject/ro-crate/pull/411) [#412](https://github.com/ResearchObject/ro-crate/pull/412) [#413](https://github.com/ResearchObject/ro-crate/pull/413) [#414](https://github.com/ResearchObject/ro-crate/pull/414) [#415](https://github.com/ResearchObject/ro-crate/pull/415) [#418](https://github.com/ResearchObject/ro-crate/pull/418) [#425](https://github.com/ResearchObject/ro-crate/pull/425)
 
-
-
-
 * [RO-Crate 1.1.2](https://github.com/ResearchObject/ro-crate/releases/tag/1.1.2) 
   * Typo fixes in [data entity section](../data-entities) [#177](https://github.com/ResearchObject/ro-crate/issues/177), [workflow section](../workflows) [#180](https://github.com/ResearchObject/ro-crate/issues/180), [metadata section](../metadata) [#181](https://github.com/ResearchObject/ro-crate/issues/181) 
   * Correct namespace for `rdfs:comment` on [ad-hoc terms](jsonld#add-local-definitions-of-ad-hoc-terms) [#164](https://github.com/ResearchObject/ro-crate/issues/164)

docs/_specification/1.3-DRAFT/appendix/implementation-notes.md

@@ -1,5 +1,6 @@
 ---
 title: Implementation notes
+description: Guidance on programming with JSON-LD, combining RO-Crate with other packaging schemes, and repository-specific identifiers
 redirect_from:
   - /1.3-DRAFT/appendix/implementation-notes
 parent: Appendix

docs/_specification/1.3-DRAFT/contextual-entities.md

@@ -494,7 +494,7 @@ This example shows how to define a place, using a [geonames] ID:
     "@id": "_:Geometry-1"
   },
   "identifier": "http://sws.geonames.org/8152662/",
-  "uri": "https://www.geonames.org/8152662/catalina-park.html",
+  "url": "https://www.geonames.org/8152662/catalina-park.html",
   "name": "Catalina Park"
 },
 {

docs/_specification/1.3-DRAFT/ro-crate-metadata.json

@@ -308,12 +308,30 @@
         {
           "@id": "http://www.w3.org/1999/02/22-rdf-syntax-ns#Property"
         },
+        {
+          "@id": "http://www.w3.org/1999/02/22-rdf-syntax-ns#subClassOf"
+        },
+        {
+          "@id": "http://www.w3.org/1999/02/22-rdf-syntax-ns#subPropertyOf"
+        },
+        {
+          "@id": "http://www.w3.org/1999/02/22-rdf-syntax-ns#label"
+        },
+        {
+          "@id": "http://www.w3.org/1999/02/22-rdf-syntax-ns#comment"
+        },
         {
           "@id": "http://schema.org/Class"
         },
         {
           "@id": "http://schema.org/Property"
         },
+        {
+          "@id": "http://schema.org/domainIncludes"
+        },
+        {
+          "@id": "http://schema.org/rangeIncludes"
+        },
         {
           "@id": "http://www.opengis.net/ont/geosparql#Geometry"
         },
@@ -517,6 +535,7 @@
       "inDefinedTermSet": {
         "@id": "http://www.w3.org/1999/02/22-rdf-syntax-ns#"
       },
+      "termCode": "rdfs:Class",
       "name": "Class (rdfs)",
       "description": "Class definition",
       "url": "https://www.w3.org/TR/rdf-schema/#ch_class"
@@ -527,10 +546,105 @@
       "inDefinedTermSet": {
         "@id": "http://www.w3.org/1999/02/22-rdf-syntax-ns#"
       },
+      "termCode": "rdfs:Property",
       "name": "Property (rdfs)",
-      "description": "Property definition, typically with domainIncludes and rangeIncludes",
+      "description": "Property definition, in schema.org style schema typically with domainIncludes and rangeIncludes",
       "url": "https://www.w3.org/TR/rdf-schema/#ch_property"
     },
+    {
+      "@id": "http://www.w3.org/1999/02/22-rdf-syntax-ns#subPropertyOf",
+      "@type": ["DefinedTerm","rdfs:Property"],
+      "inDefinedTermSet": {
+        "@id": "http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+      },
+      "termCode": "rdfs:subPropertyOf",
+      "name": "subPropertyOf (rdfs)",
+      "domainIncludes": { "@id": "http://www.w3.org/1999/02/22-rdf-syntax-ns#Property"},
+      "rangeIncludes": { "@id": "http://www.w3.org/1999/02/22-rdf-syntax-ns#Property"},
+      "description": "A subproperty is a specialisation of another property",
+      "url": "https://www.w3.org/TR/rdf-schema/#ch_subpropertyof"
+    },
+    {
+      "@id": "http://www.w3.org/1999/02/22-rdf-syntax-ns#subClassOf",
+      "@type": ["DefinedTerm","rdfs:Property"],
+      "inDefinedTermSet": {
+        "@id": "http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+      },
+      "domainIncludes": { "@id": "http://www.w3.org/1999/02/22-rdf-syntax-ns#Class"},
+      "rangeIncludes": { "@id": "http://www.w3.org/1999/02/22-rdf-syntax-ns#Class"},
+      "termCode": "rdfs:subClassOf",
+      "name": "subClassOf (rdfs)",
+      "description": "A subclass is a specialisation of another class",
+      "url": "https://www.w3.org/TR/rdf-schema/#ch_subclassof"
+    },
+    {
+      "@id": "http://www.w3.org/1999/02/22-rdf-syntax-ns#label",
+      "@type": ["DefinedTerm","rdfs:Property"],
+      "inDefinedTermSet": {
+        "@id": "http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+      },
+      "domainIncludes": [ 
+        { "@id": "http://www.w3.org/1999/02/22-rdf-syntax-ns#Property"},
+        { "@id": "http://www.w3.org/1999/02/22-rdf-syntax-ns#Class"}        
+      ],
+      "rangeIncludes": { "@id": "http://schema.org/Text"},
+      "termCode": "rdfs:label",
+      "name": "label (rdfs)",
+      "description": "A human-readable name of the property/class defined with RDFS, equivalent to 'name' in schema.org",
+      "url": "https://www.w3.org/TR/rdf-schema/#ch_label"
+    },     
+    {
+      "@id": "http://www.w3.org/1999/02/22-rdf-syntax-ns#comment",
+      "@type": ["DefinedTerm","rdfs:Property"],
+      "inDefinedTermSet": {
+        "@id": "http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+      },
+      "domainIncludes": [ 
+        { "@id": "http://www.w3.org/1999/02/22-rdf-syntax-ns#Property"},
+        { "@id": "http://www.w3.org/1999/02/22-rdf-syntax-ns#Class"}        
+      ],
+      "rangeIncludes": { "@id": "http://schema.org/Text"},      
+      "termCode": "rdfs:comment",
+      "name": "comment (rdfs)",
+      "description": "A human-readable description of the property/class defined with RDFS, equivalent to 'description' in schema.org",
+      "url": "https://www.w3.org/TR/rdf-schema/#ch_comment"
+    },
+    {
+      "@id": "http://schema.org/domainIncludes",
+      "@type": ["DefinedTerm","rdfs:Property"],
+      "inDefinedTermSet": {
+        "@id": "https://schema.org/docs/releases.html#v22.0"
+      },
+      "name": "domainIncludes",
+      "termCode": "domainIncludes",
+      "domainIncludes": [
+        {"@id": "http://schema.org/Class"},
+        {"@id": "http://www.w3.org/1999/02/22-rdf-syntax-ns#Class"}
+      ],
+      "rangeIncludes": [
+        {"@id": "http://schema.org/Class"},
+        {"@id": "http://www.w3.org/1999/02/22-rdf-syntax-ns#Class"}
+      ],
+      "description": "The domain of a property includes the given classes, meaning the property may be used on instances of these classes. Equivalent to rdfs:domain but allowing multiple disjoint classes."      
+    },
+    {
+      "@id": "http://schema.org/rangeIncludes",
+      "@type": ["DefinedTerm","rdfs:Property"],
+      "inDefinedTermSet": {
+        "@id": "https://schema.org/docs/releases.html#v22.0"
+      },
+      "domainIncludes": [
+        {"@id": "http://schema.org/Class"},
+        {"@id": "http://www.w3.org/1999/02/22-rdf-syntax-ns#Class"}
+      ],
+      "rangeIncludes": [
+        {"@id": "http://schema.org/Class"},
+        {"@id": "http://www.w3.org/1999/02/22-rdf-syntax-ns#Class"}
+      ],      
+      "name": "rangeIncludes",
+      "termCode": "rangeIncludes",
+      "description": "The range of a property includes the given types, meaning instances of these types may be the target of this property. Equivalent to rdfs:range but allowing multiple disjoint types. For datatype properties, point to subclasses of http://schema.org/DataType e.g. for a string, http://schema.org/Text"
+    },    
     {
       "@id": "http://schema.org/Class",
       "@type": ["DefinedTerm","Class"],
@@ -549,6 +663,7 @@
       "name": "Property (schema.org)",
       "description": "Property reference, as indicated by @id url or inDefinedTermSet"      
     },
+
     { 
       "@id": "http://schema.org/MediaObject",
       "@type": "DefinedTerm",