Greetings OpenStack community, A short meeting today, mostly reflecting on the Birds of a Feather session [4] at Summit last week. It was well attended and engendered plenty of good discussion. There are notes on an etherpad at https://etherpad.openstack.org/p/BOS-API-WG-BOF that continue to be digested. One of the main takeaways was the group should work with people creating documentation (api-ref and otherwise) to encourage linking from those documents to the guidelines [2]. This will help to explain why some things are the way they are (for example microversions) and also highlight a path whereby people can contribute to improving or clarifying the guidelines. Working on that linking will be an ongoing effort. In the meantime the primary action for the group (and anyone else interested in API consistency) is to review Monty's efforts to document client side interactions with the service catalog and version discovery (linked below). # Newly Published Guidelines Nothing new at this time. # API Guidelines Proposed for Freeze Guidelines that are ready for wider review by the whole community. None at this time but please check out the reviews below. # Guidelines Currently Under Review [3] * Microversions: add next_min_version field in version body https://review.openstack.org/#/c/446138/ * A suite of several documents about using the service catalog and doing version discovery Start at https://review.openstack.org/#/c/462814/ * 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 WG, 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 WG mission and the work we do, see OpenStack API Working Group [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://www.openstack.org/summit/boston-2017/summit-schedule/events/18679/api-working-group-update-and-bof Meeting Agenda https://wiki.openstack.org/wiki/Meetings/API-WG#Agenda Past Meeting Records http://eavesdrop.openstack.org/meetings/api_wg/ Open Bugs https://bugs.launchpad.net/openstack-api-wg -- Chris Dent ┬──┬◡ﾉ(° -°ﾉ) https://anticdent.org/ freenode: cdent tw: @anticdent