search

Open-EO / openeo-api

The openEO API specification
http://api.openeo.org
Apache License 2.0
91 stars 11 forks source link

Recommend against versioning on minor level #393

Closed m-mohr closed 3 years ago

m-mohr commented 3 years ago

The API recommends versioning with major and minor version number, e.g. v1.0. in the URL. As we are following semver this seems not ideal. Better would probably be to just use v1 for versioning.

soxofaan commented 3 years ago

Are you just talking about the backend URL? Or other version discovery/negotiation mechanisms as well?

In other word, do you mean

... version number, e.g. v1.0. in the URL.

or

... version number, e.g. v1.0., in the URL.

hashtag punctuation! :stuck_out_tongue:

m-mohr commented 3 years ago

Yeah, a typo. Just talking about the back-end URL. It's just a recommendation anyway, but I guess having a v1.1 and v1.0 instance usually doesn't make much sense due to SemVer. That's the only point here...

m-mohr commented 3 years ago

Actually, the description was already saying v1 (major path) should be used, but the default value was still v1.0. Fixed.