Recommend against versioning on minor level

[m-mohr]

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]

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! 😛

[m-mohr]

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]

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