<p dir="ltr"><br>
On Aug 28, 2015 6:49 AM, "Sean Dague" <<a href="mailto:sean@dague.net">sean@dague.net</a>> wrote:<br>
><br>
> On 08/28/2015 09:32 AM, Alex Meade wrote:<br>
> > I don't know if this is really a big problem. IMO, even with<br>
> > microversions you shouldn't be implementing things that aren't backwards<br>
> > compatible within the major version. I thought the benefit of<br>
> > microversions is to know if a given feature exists within the major<br>
> > version you are using. I would consider a breaking change to be a major<br>
> > version bump. If we only do a microversion bump for a backwards<br>
> > incompatible change then we are just using microversions as major versions.<br>
><br>
> In the Nova case, Microversions aren't semver. They are content<br>
> negotiation. Backwards incompatible only means something if time's arrow<br>
> only flows in one direction. But when connecting to a bunch of random<br>
> OpenStack clouds, there is no forced progression into the future.<br>
><br>
> While each service is welcome to enforce more compatibility for the sake<br>
> of their users, one should not assume that microversions are semver as a<br>
> base case.<br>
><br>
> I agree that 'latest' is basically only useful for testing. The</p>
<p dir="ltr">Sounds like we need to update the docs for this.<br></p>
<p dir="ltr">> python-novaclient code requires a microversion be specified on the API<br>
> side, and on the CLI side negotiates to the highest version of the API<br>
> that it understands which is supported on the server -<br>
> <a href="https://github.com/openstack/python-novaclient/blob/d27568eab50b10fc022719172bc15666f3cede0d/novaclient/__init__.py#L23">https://github.com/openstack/python-novaclient/blob/d27568eab50b10fc022719172bc15666f3cede0d/novaclient/__init__.py#L23</a><br></p>
<p dir="ltr">Considering how unclear these two points appear to be, are they clearly documented somewhere? So that as more projects embrace microversions, they don't end up having the same discussion.</p>
<p dir="ltr">><br>
>         -Sean<br>
><br>
> --<br>
> Sean Dague<br>
> <a href="http://dague.net">http://dague.net</a><br>
><br>
> __________________________________________________________________________<br>
> OpenStack Development Mailing List (not for usage questions)<br>
> Unsubscribe: <a href="http://OpenStack-dev-request@lists.openstack.org?subject:unsubscribe">OpenStack-dev-request@lists.openstack.org?subject:unsubscribe</a><br>
> <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a><br>
</p>