Merge pull request #217 from alien-mcl/issue/216_how_to_document_forb…

…idden_dereferencability How to document forbidden dereferencability
HydraCG · Oct 27, 2020 · a8405ae · a8405ae
2 parents 3d6d1f6 + 8002cd7
commit a8405ae
Showing 1 changed file with 8 additions and 21 deletions.
diff --git a/spec/latest/core/core.jsonld b/spec/latest/core/core.jsonld
@@ -95,17 +95,16 @@
     {
       "@id": "hydra:Resource",
       "@type": "hydra:Class",
-      "subClassOf": "rdfs:Resource",
       "label": "Hydra Resource",
-      "comment": "The class of dereferenceable resources.",
+      "comment": "The class of dereferenceable resources by means a client can attempt to dereference; however, the received responses should still be verified.",
       "vs:term_status": "testing"
     },
     {
       "@id": "hydra:Class",
       "@type": [ "hydra:Resource", "rdfs:Class" ],
-      "subClassOf": [ "hydra:Resource", "rdfs:Class" ],
+      "subClassOf": [ "rdfs:Class" ],
       "label": "Hydra Class",
-      "comment": "The class of Hydra classes. Hydra classes and their instances are dereferenceable resources.",
+      "comment": "The class of Hydra classes.",
       "vs:term_status": "testing"
     },
     {
@@ -148,7 +147,7 @@
       "label": "supported classes",
       "comment": "A class known to be supported by the Web API",
       "domain": "hydra:ApiDocumentation",
-      "range": "hydra:Class",
+      "range": "rdfs:Class",
       "vs:term_status": "testing"
     },
     {
@@ -165,14 +164,13 @@
       "@type": "hydra:Link",
       "label": "supported properties",
       "comment": "The properties known to be supported by a Hydra class",
-      "domain": "hydra:Class",
+      "domain": "rdfs:Class",
       "range": "hydra:SupportedProperty",
       "vs:term_status": "testing"
     },
     {
       "@id": "hydra:SupportedProperty",
       "@type": "hydra:Class",
-      "subClassOf": "hydra:Resource",
       "label": "Supported Property",
       "comment": "A property known to be supported by a Hydra class.",
       "vs:term_status": "testing"
@@ -219,7 +217,7 @@
       "label": "supported operation",
       "comment": "An operation supported by instances of the specific Hydra class or the target of the Hydra link",
       "range": "hydra:Operation",
-      "domainIncludes": ["hydra:Class", "hydra:Link", "hydra:TemplatedLink", "hydra:SupportedProperty"],
+      "domainIncludes": ["rdfs:Class", "hydra:Class", "hydra:Link", "hydra:TemplatedLink", "hydra:SupportedProperty"],
       "vs:term_status": "testing"
     },
     {
@@ -234,7 +232,6 @@
     {
       "@id": "hydra:Operation",
       "@type": "hydra:Class",
-      "subClassOf": "hydra:Resource",
       "label": "Operation",
       "comment": "An operation.",
       "vs:term_status": "testing"
@@ -254,8 +251,7 @@
       "label": "expects",
       "comment": "The information expected by the Web API.",
       "domain": "hydra:Operation",
-      "range": "hydra:Resource",
-      "rangeIncludes": ["hydra:Resource", "hydra:Class"],
+      "rangeIncludes": ["rdfs:Resource", "hydra:Resource", "rdfs:Class", "hydra:Class"],
       "vs:term_status": "testing"
     },
     {
@@ -264,14 +260,12 @@
       "label": "returns",
       "comment": "The information returned by the Web API on success",
       "domain": "hydra:Operation",
-      "range": "hydra:Resource",
-      "rangeIncludes": ["hydra:Resource", "hydra:Class"],
+      "rangeIncludes": ["rdfs:Resource", "hydra:Resource", "rdfs:Class", "hydra:Class"],
       "vs:term_status": "testing"
     },
     {
       "@id": "hydra:Status",
       "@type": "hydra:Class",
-      "subClassOf": "hydra:Resource",
       "label": "Status code description",
       "comment": "Additional information about a status code that might be returned.",
       "vs:term_status": "testing"
@@ -340,7 +334,6 @@
       "@type": "hydra:Link",
       "label": "collection",
       "comment": "Collections somehow related to this resource.",
-      "domain": "hydra:Resource",
       "range": "hydra:Collection",
       "vs:term_status": "testing"
     },
@@ -369,16 +362,13 @@
       "label": "member",
       "comment": "A member of the collection",
       "domain": "hydra:Collection",
-      "range": "hydra:Resource",
       "vs:term_status": "testing"
     },
     {
       "@id": "hydra:view",
       "@type": "hydra:Link",
       "label": "view",
       "comment": "A specific view of a resource.",
-      "domain": "hydra:Resource",
-      "range": "hydra:Resource",
       "vs:term_status": "testing"
     },
     {
@@ -463,7 +453,6 @@
     {
       "@id": "hydra:IriTemplate",
       "@type": "hydra:Class",
-      "subClassOf": "hydra:Resource",
       "label": "IRI Template",
       "comment": "The class of IRI templates.",
       "vs:term_status": "testing"
@@ -499,7 +488,6 @@
     {
       "@id": "hydra:VariableRepresentation",
       "@type": "hydra:Class",
-      "subClassOf": "hydra:Resource",
       "label": "VariableRepresentation",
       "comment": "A representation specifies how to serialize variable values into strings.",
       "vs:term_status": "testing"
@@ -530,7 +518,6 @@
     {
       "@id": "hydra:IriTemplateMapping",
       "@type": "hydra:Class",
-      "subClassOf": "hydra:Resource",
       "label": "IriTemplateMapping",
       "comment": "A mapping from an IRI template variable to a property.",
       "vs:term_status": "testing"