API Versioning

[chrishowell]

QualityOnDemand/code/API_definitions/qod-api.yaml

Line 82 in 5f0002e

default: qod/v0

Is there a reason why the base path versioning is always using v0? these specs are not backwards compatible.

[hdamker]

The reason is that we are still in initial development / alpha status.

cf.: https://semver.org/#spec-item-4 ... "Major version zero (0.y.z) is for initial development. Anything MAY change at any time. The public API SHOULD NOT be considered stable."

I'm also not happy about the base path versioning v0. I had proposed in other places v0alpha1, v0alpha2 etc, but that was not understood and/or accepted.

If you have a proposal on improving the versioning in this initial phase you are welcome to do it in commonalities. See also this discussion we had a while ago: camaraproject/WorkingGroups#137