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

Should we version the schema? #13

Closed RaySinnema closed 9 years ago

RaySinnema commented 9 years ago

Do we need a version attribute on the service element, or a version indication in the RADL namespace URI?

gentlewind commented 9 years ago

Is it a version label for the RADL schema or the version label for the designed RADL document? They are two different problems.

RaySinnema commented 9 years ago

I meant the RADL schema.

I don't see much value in a version on the designed service, since you'd most likely store it in version control anyway. I guess if you make breaking changes to your API it might be useful to have a version.