<div dir="ltr"><div>Hi, folks</div><div><br></div>Nova API sub-team is working on the swagger generation. And there is PoC <a href="https://review.openstack.org/233446">https://review.openstack.org/233446</a><div><br></div><div>But before we are going to next step, I really hope we can get agreement with how to support Microversions and Actions. The PoC have demo about Microversions. It generates min version action as swagger spec standard, for the other version actions, it named as extended attribute, like:</div><div><br></div><div>{</div><div>    '/os-keypairs': {</div><div>        "get": {<br></div><div>            'x-start-version': '2.1',</div><div>            'x-end-version': '2.1',</div><div>            'description': '....',</div><div>           ....</div><div>        },</div><div>        "x-get-2.2-2.9": {</div><div>            'x-start-version': '2.2',</div><div>            'x-end-version': '2.9',</div><div>            'description': '....',</div><div>            .....</div><div>        }</div><div>    }</div><div>}</div><div><br></div><div>x-start-version and x-end-version are the metadata for Microversions, which should be used by UI code to parse.<br></div><div><br></div><div>This is just based on my initial thought, and there is another thought is generating a set full swagger specs for each Microversion. But I think how to show Microversions and Actions should be depended how the doc UI to parse that also. </div><div><br></div><div>As there is doc project to turn swagger to UI: <a href="https://github.com/russell/fairy-slipper">https://github.com/russell/fairy-slipper</a>  But it didn't support Microversions. So hope doc team can work with us and help us to find out format to support Microversions and Actions which good for UI parse and swagger generation.</div><div><br></div><div>Any thoughts folks?</div><div><br></div><div>Thanks</div><div>Alex</div><div><br></div></div>