[openstack-dev] [all] [api] API Working Group Refresher
Qiming Teng
tengqim at linux.vnet.ibm.com
Mon Jan 18 02:56:06 UTC 2016
On Fri, Jan 15, 2016 at 12:48:51PM +0000, Chris Dent wrote:
>
> At yesterday's API Working Group meeting we decided it would be a
> good idea to send out a refresher on the existence of the group,
> its goals and activities. If you have interest in the improvement
> and standardization of OpenStack APIs please take this as an
> invitation to participate.
>
> The group meets once a week in openstack-meeting-3 on Thursdays
> alternating between 00:00 UTC and 16:00 UTC[0].
The meeting time is quite confusing based on info on the wiki. It says
that 'next' meeting would be 2016-01-28 at 00:00UTC, previous meeting
was 2016-01-14 at 16:00UTC. Do we have a meeting on 2016-01-21? What
timeslot should it be? 16:00UTC or 00:00UTC?
Maybe we should keep at least one 'past' meeting on the wiki page so
that people can get a better idea what's going on?
- Qiming
> The primary goal of the group is to help OpenStack HTTP APIs adhere
> to standards and be consistent in the context of OpenStack[1]. To that
> end the main activities of members are:
>
> * Creating, encouraging projects to create, and reviewing API
> guidelines:
>
> * https://review.openstack.org/#/q/project:openstack/api-wg
> * http://specs.openstack.org/openstack/api-wg/
>
> To be clear these are guidelines, not rules. The members of the
> API working group are not cops. There's an open question of
> whether the guidelines should codify existing behaviors or be more
> aspirational. If you have an opinion on such things, you might
> like to come along and share it.
>
> * Providing guidance and sounding boards for changes which impact
> HTTP APIS:
>
> * https://review.openstack.org/#/q/status:open+AND+%28message:ApiImpact+OR+message:APIImpact%29,n,z
>
> * Exploring existing APIs to get a sense of existing practices and
> tease out which are "best":
>
> * https://wiki.openstack.org/wiki/API_Working_Group/Current_Design
>
> Ideally every OpenStack project that has an HTTP API should have a
> designated cross project liaison who is willing to participate in the
> API working group and operate as bi-directional conduit. Talk to your
> PTL if you want this responsibility and then show up at the meetings.
>
> [0] https://wiki.openstack.org/wiki/Meetings/API-WG
> [1] https://wiki.openstack.org/wiki/API_Working_Group#Purpose
> --
> Chris Dent (╯°□°)╯︵┻━┻ http://anticdent.org/
> freenode: cdent tw: @anticdent
More information about the OpenStack-dev
mailing list