- 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