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

Chris Dent cdent+os at anticdent.org
Thu Jan 26 17:00:44 UTC 2017

Greetings OpenStack community,

Today's meeting [0] covered two main topics: Making sure we get input on the process for refactoring the api compatibility guidelines [4] and whether we should have some official time at the PTG. Rather than having official time we decided that the best thing to do was make sure we are available for those topics which are relevant (such as discussion of capabilities [5] and service catalog and version endpoint clarification [6]) and to hang out with the architecture working group. Of the API-WG cores, edleafe and I (cdent) will be at the PTG. Find one of us if there's something that ought to be discussed there and we'll try to set something up.

# Newly Published Guidelines

Nothing recently published.

# API Guidelines Proposed for Freeze

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

* Add guidelines on usage of state vs. status

* Clarify the status values in versions

* Add guideline for invalid query parameters

# Guidelines Currently Under Review [3]

* Add guidelines for boolean names

* Define pagination guidelines

* Add API capabilities discovery guideline

# 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

[0] http://eavesdrop.openstack.org/meetings/api_wg/2017/api_wg.2017-01-26-16.00.log.html
[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://review.openstack.org/#/c/421846/ and http://lists.openstack.org/pipermail/openstack-dev/2017-January/110384.html
[5] https://review.openstack.org/#/c/386555/
[6] http://lists.openstack.org/pipermail/openstack-dev/2017-January/110043.html

Meeting Agenda
Past Meeting Records
Open Bugs

Chris Dent                 ¯\_(ツ)_/¯           https://anticdent.org/
freenode: cdent                                         tw: @anticdent

More information about the OpenStack-dev mailing list