Open Stack

Greetings OpenStack community,

Today's meeting was brief and primarily covered planning for the PTG. 
Here's a quick recap.

We began by continuing to discuss the bug [8] that is the result of the 
Nova API not properly including caching information in the headers of 
its replies. Dmitry Tantsur has added comments to the bug and the SIG 
will most likely have more input on that report. The SIG has agreed with 
the position described by Chris Dent in the bug report, that this is bug 
and should be remedied as soon as possible. If you have thoughts on 
this, please add your perspective to that bug report.

Next we reviewed the etherpad[7] of topics for the upcoming PTG, with 
the entire group taking an action item to prioritize the issues. If you 
are interested in the topics listed on that etherpad, we invite you to 
please add a "+1" next to anything that you would like to discuss, or a 
-1 if you don't think that topic deserves discussion time.

Lastly, there was some talk of an informal API-SIG meetup for the PTG 
with no firm plans confirmed. Beers may or may not have been discussed.

As always if you're interested in helping out, in addition to coming to 
the meetings, there's also:

* The list of bugs [5] indicates several missing or incomplete guidelines.
* The existing guidelines [2] always need refreshing to account for 
changes over time. If you find something that's not quite right, submit 
a patch [6] to fix it.
* Have you done something for which you think guidance would have made 
things easier but couldn't find any? Submit a patch and help others [6].

# Newly Published Guidelines

None this week.

# API Guidelines Proposed for Freeze

Guidelines that are ready for wider review by the whole community.

None this week.

# Guidelines Currently Under Review [3]

* Add guideline on exposing microversions in SDKs
   https://review.openstack.org/#/c/532814/

* Add API-schema guide (still being defined)
   https://review.openstack.org/#/c/524467/

* A (shrinking) suite of several documents about doing version and 
service discovery
   Start at https://review.openstack.org/#/c/459405/

* WIP: microversion architecture archival doc (very early; not yet ready 
for review)
   https://review.openstack.org/444892

# Highlighting your API impacting issues

If you seek further review and insight from the API SIG about APIs that 
you are developing or changing, please address your concerns in an email 
to the OpenStack developer mailing list[1] with the tag "[api]" in the 
subject. In your email, you should include any relevant reviews, links, 
and comments to help guide the discussion of the specific challenge you 
are facing.

To learn more about the API SIG mission and the work we do, see our wiki 
page [4] and guidelines [2].

Thanks for reading and see you next week!

# References

[1] http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
[2] http://specs.openstack.org/openstack/api-wg/
[3] 
https://review.openstack.org/#/q/status:open+project:openstack/api-wg,n,z
[4] https://wiki.openstack.org/wiki/API_SIG
[5] https://bugs.launchpad.net/openstack-api-wg
[6] https://git.openstack.org/cgit/openstack/api-wg
[7] https://etherpad.openstack.org/p/api-sig-ptg-rocky
[8] https://bugs.launchpad.net/nova/+bug/1747935

Meeting Agenda
https://wiki.openstack.org/wiki/Meetings/API-SIG#Agenda
Past Meeting Records
http://eavesdrop.openstack.org/meetings/api_sig/
Open Bugs
https://bugs.launchpad.net/openstack-api-wg