[openstack-dev] [all][api] POST /api-wg/news

michael mccune msm at redhat.com
Thu Sep 8 16:59:47 UTC 2016

Greetings OpenStack community,

This week the working group has been discussing an interesting topic 
raised by Michael Krotscheck on the devel mailing list[7]. This 
discussion is mainly about how we can create a more consistent API 
version discovery mechanism across the OpenStack projects, and whether 
the discovery endpoints should be restricted by authenticated access. As 
with any cross-project effort, this topic has many nuances and we are 
hopeful that there will be a path forward to making version discovery a 
more smooth process in the future.

The meeting logs are in the usual place [5]. If you find an issue with 
an existing guideline [3] or think of one that needs to exist, make a 
bug [4].

# New guidelines

No new guidelines have been merged this week.

# API guidelines that have been recently merged

* Add the beginning of a set of guidlines for URIs
* A guideline for links
* Clear the case if the version string isn't parsable

# API guidelines proposed for freeze

The following guidelines are available for broader review by interested 
parties. These will be merged in one week if there is no further feedback.

Nothing new this week.

# Guidelines currently under review [6]

There are no new guidelines, but a change is being proposed to add a 
notice about the intent of the guidelines based on some comments from 
John Dickinson[8][9].

* add a warning about json expectations

# API Impact reviews currently open

Reviews marked as APIImpact [1] are meant to help inform the working 
group about changes which would benefit from wider inspection by group 
members and liaisons. While the working group will attempt to address 
these reviews whenever possible, it is highly recommended that 
interested parties attend the API WG meetings [2] to promote 
communication surrounding their reviews.

To learn more about the API WG mission and the work we do, see OpenStack 
API Working Group [3].

Thanks for reading and see you next week!

[2] https://wiki.openstack.org/wiki/Meetings/API-WG#Agenda
[3] http://specs.openstack.org/openstack/api-wg/
[4]: https://bugs.launchpad.net/openstack-api-wg
[5]: http://eavesdrop.openstack.org/meetings/api_wg/
[7]: http://markmail.org/message/o4k7wd7vqxon2ypk
[8]: https://review.openstack.org/#/c/322194/
[9]: https://review.openstack.org/#/c/354266/

More information about the OpenStack-dev mailing list