Greetings OpenStack community,
An after an initially slow start, today's meeting turned into a rollicking good
time. Probably because we talked about microversions.
First we discussed the need to clarify that the API-WG is governed by TC
(Technical Committee) not the UC (User Committee). The rule of thumb for
working groups is: did you go to the PTG or the Ops Meetup. We went to the PTG
and had two very productive days. Over the next few days we'll find the bits of
documentation that need to be cleared up and make sure pointers point the right
places.
We then discussed whether the point of the API-WG is the guidelines it creates
or the discussions that lead to the creation of those guidelines and the
overall better understanding of how to achieve consistency and correctness in
OpenStack APIs. What was first thought of as a fairly simple question turned
into a spirited debate spiralling out to a plan to audit the API-WG's mission
statement [2] for its own consistency and correctness. elmiko has the ball for
that, but since he'll be away next week we won't pick it up until the week
following.
We moved on from there to talk about the stability guidelines (linked in under
review below). We're getting very close, but are stuck on whether it is
worthwhile including some information about alternatives (either expressing
them as true alternatives, or explaining why they won't work). edleafe and
mugsie are going to work to bring this to a close next week. If you are
interested in this topic the logs at
http://eavesdrop.openstack.org/meetings/api_wg/2017/api_wg.2017-03-23-16.00.log.html#l-116
may be worth a look.
This summary does not do justice to the level of investment and interest that
was present in today's meeting. Thanks to everyone who showed up.
# Newly Published Guidelines
Nothing new this week.
# API Guidelines Proposed for Freeze
Guidelines that are ready for wider review by the whole community. Nothing at
the moment, but feel free to get in early on the reviews below.
# Guidelines Currently Under Review [3]
* Define pagination guidelines (recently rebooted)
https://review.openstack.org/#/c/446716/
* Create a new set of api stability guidelines
https://review.openstack.org/#/c/421846/
* Microversions: add next_min_version field in version body
https://review.openstack.org/#/c/446138/
* Mention max length limit information for tags
https://review.openstack.org/#/c/447344/
* Add API capabilities discovery guideline
https://review.openstack.org/#/c/386555/
* 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
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
__________________________________________________________________________
OpenStack Development Mailing List (not for usage questions)
Unsubscribe: openstack-dev-requ...@lists.openstack.org?subject:unsubscribe
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev