- From: Paul Sadauskas <paul@sadauskas.com>
- Date: Thu, 31 Dec 2015 11:13:56 -0700
- To: public-hydra@w3.org
- Message-ID: <56857064.1080606@sadauskas.com>
Hi list, I'm working on a hydra generator tool in Ruby, and as part of my tests, I wanted to make sure it generated a comparable vocab as the one in the example app at http://www.markus-lanthaler.com/hydra/api-demo/. Upon investigating the "supportedOperation" section, the example app's vocab looks like this: { "@id": "vocab:User", "@type": "hydra:Class", "subClassOf": null, "label": "User", "description": "A User represents a person registered in the system.", "supportedOperation": [ { "@id": "_:user_replace", "@type": "hydra:Operation", "method": "PUT", "label": "Replaces an existing User entity", "description": null, "expects": "vocab:User", "returns": "vocab:User", "statusCodes": [ { "code": 404, "description": "If the User entity wasn't found." } ] }, The part I had a question about is the "label" and "description" fields in the SupportedOperation. Comparing them to the "label" and "description" fields of the User resource itself, they seem to be switched. And when comparing it to the example given in the Hydra Spec (EXAMPLE 10 in http://www.hydra-cg.com/spec/latest/core/), I see that it uses "title", and no "label" or "description" at all. Is the example app simply out-of-date with the spec? Forgive my ignorance, as I'm still new to Hydra, JSONLD and RDF, but which of those is responsible for the "label" field? Perhaps my confusion is related to "ISSUE 8" in the spec, "Describe the various properties of an operation.", and once that happens, things will be clearer. Is this section still subject to much change, and I shouldn't worry about getting it to match either the spec or the example app exactly for now? Thanks Paul
Received on Sunday, 3 January 2016 07:59:34 UTC