search

restful-api-description-language / RADL

RADL: A description language and tooling for hypermedia-driven RESTful APIs
Apache License 2.0
23 stars 5 forks source link

Add <specification> to <link-relation> #15

Closed RaySinnema closed 9 years ago

RaySinnema commented 9 years ago

Just like media types, link relations can be documented in a specification, so it makes sense to express that in RADL. Currently, you have to use a <radl:documentation> element with an <html:a href="..."> or <ref uri="...">.

RaySinnema commented 9 years ago

Also, what about status codes, headers, and URI query parameters?

jonathanrobie commented 9 years ago

+1 for all elements mentioned in the first two comments, except for status codes (which are enumerated).

RaySinnema commented 9 years ago

Status codes are fixed by the schema, so those don't make sense. +1 on the others.

gentlewind commented 9 years ago

+1