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
__________________________________________________________________________
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