Greetings OpenStack community,
This week's meeting of the working group talked about the discussion at the API-WG
"birds of a feather" at last week's summit in Barcelona. Thanks to everyone who
showed up for that. I hope it was interesting and useful. Also thanks very much to all
the people who participated in the API UX feedback sessions[8]. Piet has gathered the raw
data together and will be producing a digested summary soon. From looking at the raw data
it is clear people get a lot of value out of the APIs and while we still have work to do
to make them excellent, the directions we're moving to do so (e.g., consistency, better
error information) are good.
There are a few new guidelines and newly frozen guidelines this week. See
below. Thanks to everyone who has helped to create and refine those.
# New guidelines
There are no new guidelines that have been merged this week.
# API guidelines that have been recently merged
No recent guidelines.
# 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.
* Add guidelines for complex queries
https://review.openstack.org/#/c/386614/
* Specify time intervals based filtering queries
https://review.openstack.org/#/c/383862/
* Clarify why CRUD is not a great descriptor
https://review.openstack.org/#/c/392156/
# Guidelines currently under review [6]
* Define pagination guidelines
https://review.openstack.org/#/c/390973/
* WIP Add API capabilities discovery guideline
https://review.openstack.org/#/c/386555/
# 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
[8]:
https://wiki.openstack.org/wiki/UX#Participate_in_a_usability_study_being_conducted_at_the_Barcelona_Summit.21
--
Chris Dent ┬─┬ノ( º _ ºノ) https://anticdent.org/
freenode: cdent tw: @anticdent
__________________________________________________________________________
OpenStack Development Mailing List (not for usage questions)
Unsubscribe: openstack-dev-requ...@lists.openstack.org?subject:unsubscribe
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
