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

Chris Dent cdent+os at anticdent.org
Thu Nov 17 17:08:55 UTC 2016

Greetings OpenStack community,

A pleasant but short meeting this week. During the open discussion we all agreed that the increased activity on the mailing list using the [api] tag -- with explicit invitations to engage in discussions -- was great to see happening and great to participate in. At least as great is the open discussion about how to do negation [7] which has led to a proposed guideline [8].

The pagination and capabilities guidelines (below) mentioned last week as being important and difficult continue to be actively discussed but have not yet reached consensus.

# New guidelines

No newly merged guidelines this week.

# API guidelines that have been recently merged

* Clarify why CRUD is not a great descriptor
* Add guidelines for complex queries
* Specify time intervals based filtering queries

# API guidelines proposed for freeze

No guidelines are frozen at the moment.

# Guidelines currently under review [6]

Both of these are going to require quite a bit of input from a wide audience. Both have been tried a few times in the past.

* Define pagination guidelines

* WIP Add API capabilities discovery guideline

This one is new:

* Add the operator for "not in" to the filter guideline

# 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
[5]: http://eavesdrop.openstack.org/meetings/api_wg/
[6]: https://review.openstack.org/#/q/status:open+project:openstack/api-wg,n,z
[7]: http://markmail.org/message/yr3ex6u6kcv4itty
[8]: https://review.openstack.org/#/c/399131/

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

More information about the OpenStack-dev mailing list