<div dir="ltr">As you are probably aware an api-wg guideline for microversioning is under review [1]<div>Needless to say, neutron developers interested in this work should have a look at [1] - if nothing else because we need to ensure we are aligned - and influence the guideline were appropriate.</div><div><br></div><div>Experimental APIs are one item where Neutron is not already aligned with the proposed guideline - and with the project already implementing microversioning.</div><div>While it is known that nova chose to adopt experimental APIs only as a temporary mechanism [2], the idea of experimental APIs got pretty much slammed down unanimously in an Ironic meeting (in [3] it sounds like the word 'experimental' really tickles the Ironic development team).</div><div>Therefore, Neutron needs to rethink the proposed API evolution strategy without experimental APIs. Every new API introduced will be versioned. While versioning still allows us to evolve the API as we wish, the drawback is that we'll have to expect several backward incompatible changes while new APIs stabilise after being introduced.</div><div><br></div><div>On the practical stuff matter, I am going to add soon a list of todo items to spec [4] (which we'll probably amend anyway to reflect outcome the discussion on [1]). If you're interested in cooperating in this effort, please pick one item. If we achieve a decent number of "volunteers" we'll try and set up a weekly meeting.</div><div><br></div><div>One aspect where general feedback would be welcome is whether the microversioning work should be based on master or piggyback on the pecan switch effort - therefore implementing versioning directly in the new framework. The pecan switch is being implemented in a feature branch [5]</div><div><div><br></div><div>Thanks for your attention,</div><div>Salvatore</div><div><br></div><div>[1] <a href="https://review.openstack.org/#/c/187112/">https://review.openstack.org/#/c/187112/</a></div></div><div>[2] <a href="http://specs.openstack.org/openstack/nova-specs/specs/kilo/implemented/api-microversions.htm">http://specs.openstack.org/openstack/nova-specs/specs/kilo/implemented/api-microversions.htm</a></div><div>[3] <a href="http://eavesdrop.openstack.org/meetings/ironic/2015/ironic.2015-06-15-17.02.log.html">http://eavesdrop.openstack.org/meetings/ironic/2015/ironic.2015-06-15-17.02.log.html</a></div><div>[4] <a href="http://specs.openstack.org/openstack/neutron-specs/specs/liberty/microversioning.html">http://specs.openstack.org/openstack/neutron-specs/specs/liberty/microversioning.html</a></div><div>[5] <a href="https://review.openstack.org/#/q/status:open+project:openstack/neutron+branch:feature/pecan,n,z">https://review.openstack.org/#/q/status:open+project:openstack/neutron+branch:feature/pecan,n,z</a></div></div>