[openstack-dev] [all][api] POST /api-wg/news
msm at redhat.com
Thu Feb 9 16:47:43 UTC 2017
Greetings OpenStack community,
This week's meeting was relatively light, with some discussion about
the recently released Ethercalc, and the first draft of the API
compatiblity guideline (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
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
* Add guidelines on usage of state vs. status
* Clarify the status values in versions
# API Guidelines Proposed for Freeze
Guidelines that are ready for wider review by the whole community.
* Add guidelines for boolean names
# Guidelines Currently Under Review 
* Define pagination guidelines
* Add API capabilities discovery guideline
* Refactor and re-validate api change guidelines
# 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
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 .
Thanks for reading and see you next week!
Past Meeting Records
More information about the OpenStack-dev