Greetings OpenStack community,
No new guidelines this week but we did have a very productive time creating
launchpad bugs for all the TODOs that are in the existing guidelines. The idea
is that using launchpad will help to keep the TODOs visible and encourage
action. See them at
https://bugs.launchpad.net/openstack-api-wg/+bugs?field.tag=todo
And, of course, if you think there are bugs in the guidelines, report them.
We also decided that the great big "THIS A DRAFT" warning at the start of the
guidelines [1] suggests that the guidelines are not ready. They are ready but they are
also live documents that evolve. A review is in place to remove the warning [2].
# Recently merged guidelines
Nothing new in the last two weeks.
# 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
* Add guideline for Experimental APIs
https://review.openstack.org/273158
* Add version discovery guideline
https://review.openstack.org/254895
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 [3] 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 [4] to promote communication surrounding their reviews.
Thanks for reading and see you next week!
[1] http://specs.openstack.org/openstack/api-wg/
[2] https://review.openstack.org/#/c/330687/
[3]
https://review.openstack.org/#/q/status:open+AND+(message:ApiImpact+OR+message:APIImpact),n,z
[4] https://wiki.openstack.org/wiki/Meetings/API-WG#Agenda
--
Chris Dent (╯°□°)╯︵┻━┻ http://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
