openservicebrokerapi / servicebroker

Open Service Broker API Specification
https://openservicebrokerapi.org/
Apache License 2.0
1.19k stars 434 forks source link

Spec major versions support and lifecycle? #320

Closed angarg12 closed 6 years ago

angarg12 commented 7 years ago

I was thinking today about the future v3 of the spec, and then it came to my mind that, as far as I know, we haven't defined or discussed a lifecycle plan for major versions.

If we make a version 3 release, what will happen to the latest release of version 2? Will we backport new features and fixes to version 2? For how long will we support it?

@avade maybe the experience from Cloud Foundry moving from v1 to v2 could help here?

duglin commented 7 years ago

I've been assuming that once we create a v3 we'd stop all work on v2, except perhaps "hot fixes" for critical things, but mainly full stop.

angarg12 commented 7 years ago

My line of thought was that brokers may wish to support both major versions for a short while to give their clients time to migrate to the new one.

In any case it could be a good idea to explicitly write down our policy, something along the lines "when a new major version is released, development of the previous version will cease. Previous versions will receive fixes for 6 months after the release of a new major version.".

angarg12 commented 7 years ago

Acknowledged! I will look into this and write a proposal.