Merge pull request #200 from alien-mcl/feature/Enable_hydra_to_expect…

…_and_return_non_RDF_resources

Enable hydra to expect and return non RDF resources

spec/latest/core/core.jsonld

@@ -77,7 +77,8 @@
     "subClassOf": { "@id": "rdfs:subClassOf", "@type": "@vocab" },
     "subPropertyOf": { "@id": "rdfs:subPropertyOf", "@type": "@vocab" },
     "seeAlso": { "@id": "rdfs:seeAlso", "@type": "@id" },
-    "domainIncludes": { "@id": "schema:domainIncludes", "@type": "@id" }
+    "domainIncludes": { "@id": "schema:domainIncludes", "@type": "@id" },
+    "rangeIncludes": { "@id": "schema:rangeIncludes", "@type": "@id" }
   },
   "@id": "http://www.w3.org/ns/hydra/core",
   "@type": "owl:Ontology",
@@ -253,7 +254,8 @@
       "label": "expects",
       "comment": "The information expected by the Web API.",
       "domain": "hydra:Operation",
-      "range": "hydra:Class",
+      "range": "hydra:Resource",
+      "rangeIncludes": ["hydra:Resource", "hydra:Class"],
       "vs:term_status": "testing"
     },
     {
@@ -262,7 +264,8 @@
       "label": "returns",
       "comment": "The information returned by the Web API on success",
       "domain": "hydra:Operation",
-      "range": "hydra:Class",
+      "range": "hydra:Resource",
+      "rangeIncludes": ["hydra:Resource", "hydra:Class"],
       "vs:term_status": "testing"
     },
     {

spec/latest/core/index.html

@@ -535,6 +535,11 @@ <h3>Documenting a Web API</h3>
       user has the permission to delete the resource. Otherwise, the link
       would simply be hidden in the representation.</p>
 
+    <p>Example shown below describes the operation's expected and returned
+      value as a dereferencable resource (an RDF resource of a given class),
+      but the vocabulary is not limited to only those originating
+      from RDF and is enabled to other types of resources.</p>
+
     <pre class="example nohighlight" data-transform="updateExample"
          title="Documenting the supported operations of link properties">
       <!--