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

michael mccune msm at redhat.com
Thu Jul 14 16:35:13 UTC 2016


Greetings OpenStack community,

No new guidelines have been merged or proposed for freeze this week.

There are 19 outstanding issues in the launchpad bug tracker for the 
working group[4], and we are always looking for more help from the 
community. A few hot issues currently are the need for an acceptable 
guideline on pagination, and some history and advice on why extensions 
have not worked and should not be used. If you are interested in helping 
the effort, please take a look at the issues and reach out to the group.

# Recently merged guidelines

No new guidelines in the last two weeks but the following fixes were merged:

* Get rid of the DRAFT warning at the top of guidelines
   https://review.openstack.org/#/c/330687/
* Remove "Conveying error/fault information" section
   https://review.openstack.org/#/c/330876/

# 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.

None this week

# Guidelines currently under review

These are guidelines that the working group are debating and working on 
for consistency and language. We encourage any interested parties to 
join in the conversation.

* Add the beginning of a set of guidlines for URIs
   https://review.openstack.org/#/c/322194/
* Add description of pagination parameters
   https://review.openstack.org/190743

Note that some of these guidelines were introduced quite a long time ago 
and need to either be refreshed by their original authors, or adopted by 
new interested parties. If you're the author of one of these older 
reviews, please come back to it or we'll have to mark it abandoned.

# 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!

[1] 
https://review.openstack.org/#/q/status:open+AND+(message:ApiImpact+OR+message:APIImpact),n,z
[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




More information about the OpenStack-dev mailing list