Re: [openstack-dev] [all] [api] API Working Group Refresher

2016-01-18 Thread Everett Toews

On Jan 17, 2016, at 8:56 PM, Qiming Teng 
> wrote:

On Fri, Jan 15, 2016 at 12:48:51PM +, 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?

I updated the meeting page to have the correct next meeting at 2016-01-21 at 
00:00 UTC.

Apologies for the confusion.

Everett
__
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


Re: [openstack-dev] [all] [api] API Working Group Refresher

2016-01-17 Thread Qiming Teng
On Fri, Jan 15, 2016 at 12:48:51PM +, 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



__
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


[openstack-dev] [all] [api] API Working Group Refresher

2016-01-15 Thread Chris Dent


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 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   (�s°□°)�s�喋擤ォ�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