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

michael mccune msm at redhat.com
Thu Feb 9 16:47:43 UTC 2017


Greetings OpenStack community,

This week's meeting[0] was relatively light, with some discussion about 
the recently released Ethercalc[4], and the first draft of the API 
compatiblity guideline[5] (many thanks to Chris Dent). The compatibility 
guideline lays out some concrete standards by which projects can 
definitely determine if they are following the API guidelines in 
general, and how closely their efforts track. This work is part of the 
foundation for creating an API compatiblity tag which projects can apply 
for.

One reminder: Projects should make sure that their liaison information 
is up to date at 
http://specs.openstack.org/openstack/api-wg/liaisons.html . If not, 
please provide a patch to doc/source/liaisons.json to update it.

One guideline was frozen this week.

# Newly Published Guidelines

* Add guideline for invalid query parameters
   https://review.openstack.org/#/c/417441/
* Add guidelines on usage of state vs. status
   https://review.openstack.org/#/c/411528/
* Clarify the status values in versions
   https://review.openstack.org/#/c/411849/

# API Guidelines Proposed for Freeze

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

* Add guidelines for boolean names
   https://review.openstack.org/#/c/411529/

# Guidelines Currently Under Review [3]

* Define pagination guidelines
   https://review.openstack.org/#/c/390973/

* Add API capabilities discovery guideline
   https://review.openstack.org/#/c/386555/

* Refactor and re-validate api change guidelines
   https://review.openstack.org/#/c/421846/

# 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-02-09-16.00.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://ethercalc.openstack.org/
[5] https://review.openstack.org/#/c/421846/

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



More information about the OpenStack-dev mailing list