Re: [openstack-dev] [Nova] [All] API standards working group

2014-10-02 Thread Anne Gentle
Hi all,

Definitely attend this Friday's bootstrapping session if you're interested
in this thread. Don't let the Docs in the title throw you off. :)

https://wiki.openstack.org/wiki/BootstrappingHour/Diving_Into_Docs

Schedule: Friday Oct 3rd - 19:00 UTC (15:00 Americas/New_York)
Host(s): Sean Dague, Jay Pipes, Dan Smith
Experts(s): Anne Gentle
Youtube Stream: http://www.youtube.com/watch?v=n2I3PFuoNj4
Etherpad: https://etherpad.openstack.org/p/obh-diving-into-docs

Thanks,
Anne

On Wed, Sep 24, 2014 at 11:48 AM, Everett Toews everett.to...@rackspace.com
 wrote:

 On Sep 24, 2014, at 9:42 AM, Dean Troyer dtro...@gmail.com wrote:

  I'll bring an API consumer's perspective.

 +1

 I’d bring an API consumer’s perspective as well.

 Looks like there’s lots of support for an API WG. What’s the next step?

 Form a WG under the User Committee [1] or is there something more
 appropriate?

 Thanks,
 Everett

 [1]
 https://wiki.openstack.org/wiki/Governance/Foundation/UserCommittee#Working_Groups


 ___
 OpenStack-dev mailing list
 OpenStack-dev@lists.openstack.org
 http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev

___
OpenStack-dev mailing list
OpenStack-dev@lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev


Re: [openstack-dev] [Nova] [All] API standards working group

2014-09-24 Thread Kenichi Oomichi
 -Original Message-
 From: Jay Pipes [mailto:jaypi...@gmail.com]
 Sent: Wednesday, September 24, 2014 7:19 AM
 To: openstack-dev@lists.openstack.org
 Subject: Re: [openstack-dev] [Nova] [All] API standards working group
 
 On 09/23/2014 05:03 PM, Rochelle.RochelleGrober wrote:
  jaypi...@gmail.com mailto:jaypi...@gmail.com on Tuesday, September 23,
  2014 9:09 AM wrote:
 
  _Snip
 
  I'd like to say finally that I think there should be an OpenStack API
  working group whose job it is to both pull together a set of OpenStack
  API practices as well as evaluate new REST APIs proposed in the
  OpenStack ecosystem to provide guidance to new projects or new
  subprojects wishing to add resources to an existing REST API.
 
  Best,
 
  -jay
 
  */[Rocky Grober] /*++
 
  */Jay, are you volunteering to head up the working group? Or at least be
  an active member?  I’ll certainly follow with interest, but I think I
  have my hands full with the log rationalization working group./*
 
 Yes, I'd be willing to head up the working group... or at least
 participate in it.

I also would like to join the group.


Thanks
Ken'ichi Ohmichi


___
OpenStack-dev mailing list
OpenStack-dev@lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev


Re: [openstack-dev] [Nova] [All] API standards working group

2014-09-24 Thread Salvatore Orlando
Please keep me in the loop.

The importance of ensuring consistent style across Openstack APIs increases
as the number of integrated project increases.
Unless we decide to merge all API endpoints as proposed in another thread!
[1]

Regards,
Salvatore

[1]
http://www.mail-archive.com/openstack-dev@lists.openstack.org/msg36012.html

On 24 September 2014 11:15, Kenichi Oomichi oomi...@mxs.nes.nec.co.jp
wrote:

  -Original Message-
  From: Jay Pipes [mailto:jaypi...@gmail.com]
  Sent: Wednesday, September 24, 2014 7:19 AM
  To: openstack-dev@lists.openstack.org
  Subject: Re: [openstack-dev] [Nova] [All] API standards working group
 
  On 09/23/2014 05:03 PM, Rochelle.RochelleGrober wrote:
   jaypi...@gmail.com mailto:jaypi...@gmail.com on Tuesday, September
 23,
   2014 9:09 AM wrote:
  
   _Snip
  
   I'd like to say finally that I think there should be an OpenStack API
   working group whose job it is to both pull together a set of OpenStack
   API practices as well as evaluate new REST APIs proposed in the
   OpenStack ecosystem to provide guidance to new projects or new
   subprojects wishing to add resources to an existing REST API.
  
   Best,
  
   -jay
  
   */[Rocky Grober] /*++
  
   */Jay, are you volunteering to head up the working group? Or at least
 be
   an active member?  I’ll certainly follow with interest, but I think I
   have my hands full with the log rationalization working group./*
 
  Yes, I'd be willing to head up the working group... or at least
  participate in it.

 I also would like to join the group.


 Thanks
 Ken'ichi Ohmichi


 ___
 OpenStack-dev mailing list
 OpenStack-dev@lists.openstack.org
 http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev

___
OpenStack-dev mailing list
OpenStack-dev@lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev


Re: [openstack-dev] [Nova] [All] API standards working group

2014-09-24 Thread Alex Xu

I'm interesting in the group too!

On 2014年09月24日 18:01, Salvatore Orlando wrote:

Please keep me in the loop.

The importance of ensuring consistent style across Openstack APIs 
increases as the number of integrated project increases.
Unless we decide to merge all API endpoints as proposed in another 
thread! [1]


Regards,
Salvatore

[1] 
http://www.mail-archive.com/openstack-dev@lists.openstack.org/msg36012.html


On 24 September 2014 11:15, Kenichi Oomichi oomi...@mxs.nes.nec.co.jp 
mailto:oomi...@mxs.nes.nec.co.jp wrote:


 -Original Message-
 From: Jay Pipes [mailto:jaypi...@gmail.com
mailto:jaypi...@gmail.com]
 Sent: Wednesday, September 24, 2014 7:19 AM
 To: openstack-dev@lists.openstack.org
mailto:openstack-dev@lists.openstack.org
 Subject: Re: [openstack-dev] [Nova] [All] API standards working
group

 On 09/23/2014 05:03 PM, Rochelle.RochelleGrober wrote:
  jaypi...@gmail.com mailto:jaypi...@gmail.com
mailto:jaypi...@gmail.com mailto:jaypi...@gmail.com on
Tuesday, September 23,
  2014 9:09 AM wrote:
 
  _Snip
 
  I'd like to say finally that I think there should be an
OpenStack API
  working group whose job it is to both pull together a set of
OpenStack
  API practices as well as evaluate new REST APIs proposed in the
  OpenStack ecosystem to provide guidance to new projects or new
  subprojects wishing to add resources to an existing REST API.
 
  Best,
 
  -jay
 
  */[Rocky Grober] /*++
 
  */Jay, are you volunteering to head up the working group? Or
at least be
  an active member?  I’ll certainly follow with interest, but I
think I
  have my hands full with the log rationalization working group./*

 Yes, I'd be willing to head up the working group... or at least
 participate in it.

I also would like to join the group.


Thanks
Ken'ichi Ohmichi


___
OpenStack-dev mailing list
OpenStack-dev@lists.openstack.org
mailto:OpenStack-dev@lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev




___
OpenStack-dev mailing list
OpenStack-dev@lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev


___
OpenStack-dev mailing list
OpenStack-dev@lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev


Re: [openstack-dev] [Nova] [All] API standards working group

2014-09-24 Thread Akihiro Motoki
It is an important topics towards good user experience.
There are many inconsistencies across projects and every API has pros and cons.
We need to share API best practices and it is nice.

I am interested in the topic both as Neutron developer and
from API consumer as Horizon developer.
If the meeting time allows, I would like to join!

Regards,
Akihiro

On Wed, Sep 24, 2014 at 7:01 PM, Salvatore Orlando sorla...@nicira.com wrote:
 Please keep me in the loop.

 The importance of ensuring consistent style across Openstack APIs increases
 as the number of integrated project increases.
 Unless we decide to merge all API endpoints as proposed in another thread!
 [1]

 Regards,
 Salvatore

 [1]
 http://www.mail-archive.com/openstack-dev@lists.openstack.org/msg36012.html

 On 24 September 2014 11:15, Kenichi Oomichi oomi...@mxs.nes.nec.co.jp
 wrote:

  -Original Message-
  From: Jay Pipes [mailto:jaypi...@gmail.com]
  Sent: Wednesday, September 24, 2014 7:19 AM
  To: openstack-dev@lists.openstack.org
  Subject: Re: [openstack-dev] [Nova] [All] API standards working group
 
  On 09/23/2014 05:03 PM, Rochelle.RochelleGrober wrote:
   jaypi...@gmail.com mailto:jaypi...@gmail.com on Tuesday, September
   23,
   2014 9:09 AM wrote:
  
   _Snip
  
   I'd like to say finally that I think there should be an OpenStack API
   working group whose job it is to both pull together a set of OpenStack
   API practices as well as evaluate new REST APIs proposed in the
   OpenStack ecosystem to provide guidance to new projects or new
   subprojects wishing to add resources to an existing REST API.
  
   Best,
  
   -jay
  
   */[Rocky Grober] /*++
  
   */Jay, are you volunteering to head up the working group? Or at least
   be
   an active member?  I’ll certainly follow with interest, but I think I
   have my hands full with the log rationalization working group./*
 
  Yes, I'd be willing to head up the working group... or at least
  participate in it.

 I also would like to join the group.


 Thanks
 Ken'ichi Ohmichi


 ___
 OpenStack-dev mailing list
 OpenStack-dev@lists.openstack.org
 http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev



 ___
 OpenStack-dev mailing list
 OpenStack-dev@lists.openstack.org
 http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev




-- 
Akihiro Motoki amot...@gmail.com

___
OpenStack-dev mailing list
OpenStack-dev@lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev


Re: [openstack-dev] [Nova] [All] API standards working group

2014-09-24 Thread Lance Bragstad
You can add me to this list as well.

Thanks!

Lance

On Wed, Sep 24, 2014 at 9:41 AM, Alex Xu x...@linux.vnet.ibm.com wrote:

  I'm interesting in the group too!


 On 2014年09月24日 18:01, Salvatore Orlando wrote:

 Please keep me in the loop.

  The importance of ensuring consistent style across Openstack APIs
 increases as the number of integrated project increases.
 Unless we decide to merge all API endpoints as proposed in another thread!
 [1]

  Regards,
 Salvatore

  [1]
 http://www.mail-archive.com/openstack-dev@lists.openstack.org/msg36012.html

 On 24 September 2014 11:15, Kenichi Oomichi oomi...@mxs.nes.nec.co.jp
 wrote:

  -Original Message-
  From: Jay Pipes [mailto:jaypi...@gmail.com]
  Sent: Wednesday, September 24, 2014 7:19 AM
  To: openstack-dev@lists.openstack.org
  Subject: Re: [openstack-dev] [Nova] [All] API standards working group
 
  On 09/23/2014 05:03 PM, Rochelle.RochelleGrober wrote:
   jaypi...@gmail.com mailto:jaypi...@gmail.com on Tuesday, September
 23,
   2014 9:09 AM wrote:
  
   _Snip
  
   I'd like to say finally that I think there should be an OpenStack API
   working group whose job it is to both pull together a set of OpenStack
   API practices as well as evaluate new REST APIs proposed in the
   OpenStack ecosystem to provide guidance to new projects or new
   subprojects wishing to add resources to an existing REST API.
  
   Best,
  
   -jay
  
   */[Rocky Grober] /*++
  
   */Jay, are you volunteering to head up the working group? Or at least
 be
   an active member?  I’ll certainly follow with interest, but I think I
   have my hands full with the log rationalization working group./*
 
  Yes, I'd be willing to head up the working group... or at least
  participate in it.

 I also would like to join the group.


 Thanks
 Ken'ichi Ohmichi


 ___
 OpenStack-dev mailing list
 OpenStack-dev@lists.openstack.org
 http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev




 ___
 OpenStack-dev mailing 
 listOpenStack-dev@lists.openstack.orghttp://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev



 ___
 OpenStack-dev mailing list
 OpenStack-dev@lists.openstack.org
 http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev


___
OpenStack-dev mailing list
OpenStack-dev@lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev


Re: [openstack-dev] [Nova] [All] API standards working group

2014-09-24 Thread Ian Cordasco
On 9/24/14, 9:51 AM, Lance Bragstad lbrags...@gmail.com wrote:

You can add me to this list as well.


Thanks! 


Lance


On Wed, Sep 24, 2014 at 9:41 AM, Alex Xu
x...@linux.vnet.ibm.com wrote:

I'm interesting in the group too!


On 2014年09月24日 18:01, Salvatore Orlando wrote:




Please keep me in the loop.


The importance of ensuring consistent style across Openstack APIs
increases as the number of integrated project increases.
Unless we decide to merge all API endpoints as proposed in another
thread! [1]


Regards,
Salvatore


[1] 
http://www.mail-archive.com/openstack-dev@lists.openstack.org/msg36012.htm
l


On 24 September 2014 11:15, Kenichi Oomichi
oomi...@mxs.nes.nec.co.jp wrote:

 -Original Message-
 From: Jay Pipes [mailto:jaypi...@gmail.com]
 Sent: Wednesday, September 24, 2014 7:19 AM
 To: openstack-dev@lists.openstack.org
 Subject: Re: [openstack-dev] [Nova] [All] API standards working group

 On 09/23/2014 05:03 PM, Rochelle.RochelleGrober wrote:
  jaypi...@gmail.com mailto:jaypi...@gmail.com on Tuesday, September
23,
  2014 9:09 AM wrote:
 
  _Snip
 
  I'd like to say finally that I think there should be an OpenStack API
  working group whose job it is to both pull together a set of OpenStack
  API practices as well as evaluate new REST APIs proposed in the
  OpenStack ecosystem to provide guidance to new projects or new
  subprojects wishing to add resources to an existing REST API.
 
  Best,
 
  -jay
 
  */[Rocky Grober] /*++
 
  */Jay, are you volunteering to head up the working group? Or at least
be
  an active member?  I’ll certainly follow with interest, but I think I
  have my hands full with the log rationalization working group./*

 Yes, I'd be willing to head up the working group... or at least
 participate in it.

I also would like to join the group.


Thanks
Ken'ichi Ohmichi

I’d like to participate as well.

Cheers,
Ian

___
OpenStack-dev mailing list
OpenStack-dev@lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev


Re: [openstack-dev] [Nova] [All] API standards working group

2014-09-24 Thread Brad Topol
I am interested in participating as well.

Thanks,

Brad


Brad Topol, Ph.D.
IBM Distinguished Engineer
OpenStack
(919) 543-0646
Internet:  bto...@us.ibm.com
Assistant: Kendra Witherspoon (919) 254-0680



From:   Morgan Fainberg morgan.fainb...@gmail.com
To: Dolph Mathews dolph.math...@gmail.com, OpenStack Development 
Mailing List (not for usage questions) 
openstack-dev@lists.openstack.org, 
Date:   09/23/2014 08:01 PM
Subject:Re: [openstack-dev] [Nova] [All] API standards working 
group



-Original Message-
From: Dolph Mathews dolph.math...@gmail.com
Reply: OpenStack Development Mailing List (not for usage questions) 
openstack-dev@lists.openstack.org
Date: September 23, 2014 at 16:41:27
To: OpenStack Development Mailing List 
openstack-dev@lists.openstack.org
Subject:  Re: [openstack-dev] [Nova] [All] API standards working group

 I'd be interested in participating in this as well.
 
 I wrote Keystone's v3 Identity API Document Overview and Conventions [1]
 with an eye toward hopefully establishing *some* consistency across
 multiple projects (or at least having a starting ground with which to
 discuss and iterate on).
 
 [1]
 
https://github.com/openstack/identity-api/blob/master/v3/src/markdown/identity-api-v3.md#document-overview
 
 
 On Sep 23, 2014 6:22 PM, Jay Pipes wrote:
 
  On 09/23/2014 05:03 PM, Rochelle.RochelleGrober wrote:
 
  jaypi...@gmail.com on Tuesday, September 23,
  2014 9:09 AM wrote:
 
  _Snip
 
  I'd like to say finally that I think there should be an OpenStack API
 
  working group whose job it is to both pull together a set of 
OpenStack
 
  API practices as well as evaluate new REST APIs proposed in the
 
  OpenStack ecosystem to provide guidance to new projects or new
 
  subprojects wishing to add resources to an existing REST API.
 
  Best,
 
  -jay
 
  */[Rocky Grober] /*++
 
  */Jay, are you volunteering to head up the working group? Or at least 
be
  an active member? I’ll certainly follow with interest, but I think I
  have my hands full with the log rationalization working group./*
 
 
  Yes, I'd be willing to head up the working group... or at least
  participate in it.
 
  Best,
  -jay

I would also be interested in participating in on this front.

—Morgan

___
OpenStack-dev mailing list
OpenStack-dev@lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev


___
OpenStack-dev mailing list
OpenStack-dev@lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev


Re: [openstack-dev] [Nova] [All] API standards working group

2014-09-24 Thread Kevin L. Mitchell
On Tue, 2014-09-23 at 18:18 -0400, Jay Pipes wrote:
 Yes, I'd be willing to head up the working group... or at least 
 participate in it.

I'll raise my hand to participate…
-- 
Kevin L. Mitchell kevin.mitch...@rackspace.com
Rackspace


___
OpenStack-dev mailing list
OpenStack-dev@lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev


Re: [openstack-dev] [Nova] [All] API standards working group

2014-09-24 Thread Dean Troyer
On Tue, Sep 23, 2014 at 5:18 PM, Jay Pipes jaypi...@gmail.com wrote:

 Yes, I'd be willing to head up the working group... or at least
 participate in it.


I'll bring an API consumer's perspective.

dt

-- 

Dean Troyer
dtro...@gmail.com
___
OpenStack-dev mailing list
OpenStack-dev@lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev


Re: [openstack-dev] [Nova] [All] API standards working group

2014-09-24 Thread Everett Toews
On Sep 24, 2014, at 9:42 AM, Dean Troyer dtro...@gmail.com wrote:

 I'll bring an API consumer's perspective.  

+1

I’d bring an API consumer’s perspective as well.

Looks like there’s lots of support for an API WG. What’s the next step?

Form a WG under the User Committee [1] or is there something more appropriate?

Thanks,
Everett

[1] 
https://wiki.openstack.org/wiki/Governance/Foundation/UserCommittee#Working_Groups


___
OpenStack-dev mailing list
OpenStack-dev@lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev


Re: [openstack-dev] [Nova] [All] API standards working group

2014-09-24 Thread David Stanek
On Wed, Sep 24, 2014 at 11:42 AM, Dean Troyer dtro...@gmail.com wrote:

 On Tue, Sep 23, 2014 at 5:18 PM, Jay Pipes jaypi...@gmail.com wrote:

 Yes, I'd be willing to head up the working group... or at least
 participate in it.


 I'll bring an API consumer's perspective.



I would love to participate too. I have an interest in RESTful API design
and the surrounding architecture.

-- 
David
blog: http://www.traceback.org
twitter: http://twitter.com/dstanek
www: http://dstanek.com
___
OpenStack-dev mailing list
OpenStack-dev@lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev


Re: [openstack-dev] [Nova] [All] API standards working group

2014-09-24 Thread Jay Pipes

On 09/24/2014 12:48 PM, Everett Toews wrote:

On Sep 24, 2014, at 9:42 AM, Dean Troyer dtro...@gmail.com wrote:


I'll bring an API consumer's perspective.


+1

I’d bring an API consumer’s perspective as well.

Looks like there’s lots of support for an API WG. What’s the next step?

Form a WG under the User Committee [1] or is there something more appropriate?

Thanks,
Everett

[1] 
https://wiki.openstack.org/wiki/Governance/Foundation/UserCommittee#Working_Groups


Whatever it ends up being, it needs to have some teeth to it. Otherwise, 
we're going to end up in the exact same place we're in now, where each 
project does something slightly different.


That could mean putting the working group under the user committee and 
giving it teeth via some policy that would allow the group to look over 
proposed API changes *before* the code that implements the API was 
merged into an OpenStack project.


-jay

___
OpenStack-dev mailing list
OpenStack-dev@lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev


Re: [openstack-dev] [Nova] [All] API standards working group

2014-09-24 Thread Tim Bell

Seems like there is some overlap with the end user (i.e. consumer) working 
group at https://wiki.openstack.org/wiki/End_User_Working_Group

Sounds like it would be worth discussing with them on how to focus on these 
needs. The scope of the end user is much larger than just the API but a 
consistent API is needed for easy consumption

How about seeing with Chris Kemp where things fit together ? There is a fairly 
open structure under the user committee if you would like a place to form but 
it is important to avoid duplication. With the specs process, there is now much 
more opportunity for users (in all different forms) to give input before code 
is written.

Tim

 -Original Message-
 From: Jay Pipes [mailto:jaypi...@gmail.com]
 Sent: 24 September 2014 19:05
 To: openstack-dev@lists.openstack.org
 Subject: Re: [openstack-dev] [Nova] [All] API standards working group
 
 On 09/24/2014 12:48 PM, Everett Toews wrote:
  On Sep 24, 2014, at 9:42 AM, Dean Troyer dtro...@gmail.com wrote:
 
  I'll bring an API consumer's perspective.
 
  +1
 
  I'd bring an API consumer's perspective as well.
 
  Looks like there's lots of support for an API WG. What's the next step?
 
  Form a WG under the User Committee [1] or is there something more
 appropriate?
 
  Thanks,
  Everett
 
  [1]
  https://wiki.openstack.org/wiki/Governance/Foundation/UserCommittee#Wo
  rking_Groups
 
 Whatever it ends up being, it needs to have some teeth to it. Otherwise, we're
 going to end up in the exact same place we're in now, where each project does
 something slightly different.
 
 That could mean putting the working group under the user committee and giving
 it teeth via some policy that would allow the group to look over proposed API
 changes *before* the code that implements the API was merged into an
 OpenStack project.
 
 -jay
 
 ___
 OpenStack-dev mailing list
 OpenStack-dev@lists.openstack.org
 http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev

___
OpenStack-dev mailing list
OpenStack-dev@lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev


Re: [openstack-dev] [Nova] [All] API standards working group

2014-09-24 Thread Stefano Maffulli
On 09/24/2014 10:05 AM, Jay Pipes wrote:
 Whatever it ends up being, it needs to have some teeth to it. Otherwise,
 we're going to end up in the exact same place we're in now, where each
 project does something slightly different.

+1

I think getting started and produce some material to discuss in Paris
would be the first step. Like other teams or WG, a wiki page for the
team with a mission, roadmap, members would be a start.

I would suggest to stay close to the TC and PTLs to get buy-in from
them, increasing the chances of smooth implementations, while getting
constant feedback from downstream consumers of the APIs.

/stef

-- 
Ask and answer questions on https://ask.openstack.org

___
OpenStack-dev mailing list
OpenStack-dev@lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev


Re: [openstack-dev] [Nova] [All] API standards working group

2014-09-24 Thread Carl Baldwin
On Wed, Sep 24, 2014 at 11:05 AM, David Stanek dsta...@dstanek.com wrote:


 On Wed, Sep 24, 2014 at 11:42 AM, Dean Troyer dtro...@gmail.com wrote:

 On Tue, Sep 23, 2014 at 5:18 PM, Jay Pipes jaypi...@gmail.com wrote:

 Yes, I'd be willing to head up the working group... or at least
 participate in it.


 I'll bring an API consumer's perspective.



 I would love to participate too. I have an interest in RESTful API design
 and the surrounding architecture.

+1.  Add me to the loop for the same reasons.

Carl

 --
 David
 blog: http://www.traceback.org
 twitter: http://twitter.com/dstanek
 www: http://dstanek.com

 ___
 OpenStack-dev mailing list
 OpenStack-dev@lists.openstack.org
 http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev


___
OpenStack-dev mailing list
OpenStack-dev@lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev


Re: [openstack-dev] [Nova] [All] API standards working group

2014-09-24 Thread Chmouel Boudjnah
On Wed, Sep 24, 2014 at 12:18 AM, Jay Pipes jaypi...@gmail.com wrote:

 Yes, I'd be willing to head up the working group... or at least
 participate in it.



I am certainly interested, count me in.

Chmouel
___
OpenStack-dev mailing list
OpenStack-dev@lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev


Re: [openstack-dev] [Nova] [All] API standards working group

2014-09-24 Thread Everett Toews
On Sep 24, 2014, at 12:02 PM, Tim Bell tim.b...@cern.ch wrote:

 Seems like there is some overlap with the end user (i.e. consumer) working 
 group at https://wiki.openstack.org/wiki/End_User_Working_Group
 
 Sounds like it would be worth discussing with them on how to focus on these 
 needs. The scope of the end user is much larger than just the API but a 
 consistent API is needed for easy consumption
 
 How about seeing with Chris Kemp where things fit together ? There is a 
 fairly open structure under the user committee if you would like a place to 
 form but it is important to avoid duplication. With the specs process, there 
 is now much more opportunity for users (in all different forms) to give input 
 before code is written.

I understand your concern but I don’t think there’s too much danger of 
duplication.

I see this API WG effort as being more complementary to the EU WG than 
overlapping it. The API WG is focused on defining/implementing the API whereas 
EU WG is focused on creating application that consume the API. The place where 
they meet (and somewhat overlap) in the middle is the API.

The impetus for the API WG group needs to come from within the OpenStack 
developer community. They need to be in charge of it. They should absolutely 
seek feedback from the EU WG but trying to mix the two together wouldn’t be the 
best path forward, IMHO. 

I think you’ve got it right by suggesting that specs process would be the best 
channel for feedback between these WGs.

Everett


___
OpenStack-dev mailing list
OpenStack-dev@lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev


Re: [openstack-dev] [Nova] [All] API standards working group

2014-09-24 Thread GHANSHYAM MANN
I am very much interested to be part of this group and participate in
RESTful API design and architecture.

On Wed, Sep 24, 2014 at 7:18 AM, Jay Pipes jaypi...@gmail.com wrote:

 On 09/23/2014 05:03 PM, Rochelle.RochelleGrober wrote:

 jaypi...@gmail.com mailto:jaypi...@gmail.com on Tuesday, September 23,
 2014 9:09 AM wrote:

 _Snip

 I'd like to say finally that I think there should be an OpenStack API

 working group whose job it is to both pull together a set of OpenStack

 API practices as well as evaluate new REST APIs proposed in the

 OpenStack ecosystem to provide guidance to new projects or new

 subprojects wishing to add resources to an existing REST API.

 Best,

 -jay

 */[Rocky Grober] /*++

 */Jay, are you volunteering to head up the working group? Or at least be
 an active member?  I’ll certainly follow with interest, but I think I
 have my hands full with the log rationalization working group./*


 Yes, I'd be willing to head up the working group... or at least
 participate in it.

 Best,
 -jay

 ___
 OpenStack-dev mailing list
 OpenStack-dev@lists.openstack.org
 http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev




-- 
Thanks  Regards
Ghanshyam Mann
___
OpenStack-dev mailing list
OpenStack-dev@lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev


Re: [openstack-dev] [Nova] [All] API standards working group

2014-09-24 Thread Eli Qiao

hi all
please count me in, thanks :)

于 2014年09月24日 23:01, Ian Cordasco 写道:

On 9/24/14, 9:51 AM, Lance Bragstad lbrags...@gmail.com wrote:


You can add me to this list as well.


Thanks!


Lance


On Wed, Sep 24, 2014 at 9:41 AM, Alex Xu
x...@linux.vnet.ibm.com wrote:

I'm interesting in the group too!


On 2014年09月24日 18:01, Salvatore Orlando wrote:




Please keep me in the loop.


The importance of ensuring consistent style across Openstack APIs
increases as the number of integrated project increases.
Unless we decide to merge all API endpoints as proposed in another
thread! [1]


Regards,
Salvatore


[1]
http://www.mail-archive.com/openstack-dev@lists.openstack.org/msg36012.htm
l


On 24 September 2014 11:15, Kenichi Oomichi
oomi...@mxs.nes.nec.co.jp wrote:


-Original Message-
From: Jay Pipes [mailto:jaypi...@gmail.com]
Sent: Wednesday, September 24, 2014 7:19 AM
To: openstack-dev@lists.openstack.org
Subject: Re: [openstack-dev] [Nova] [All] API standards working group

On 09/23/2014 05:03 PM, Rochelle.RochelleGrober wrote:

jaypi...@gmail.com mailto:jaypi...@gmail.com on Tuesday, September

23,

2014 9:09 AM wrote:

_Snip

I'd like to say finally that I think there should be an OpenStack API
working group whose job it is to both pull together a set of OpenStack
API practices as well as evaluate new REST APIs proposed in the
OpenStack ecosystem to provide guidance to new projects or new
subprojects wishing to add resources to an existing REST API.

Best,

-jay

*/[Rocky Grober] /*++

*/Jay, are you volunteering to head up the working group? Or at least

be

an active member?  I’ll certainly follow with interest, but I think I
have my hands full with the log rationalization working group./*

Yes, I'd be willing to head up the working group... or at least
participate in it.

I also would like to join the group.


Thanks
Ken'ichi Ohmichi

I’d like to participate as well.

Cheers,
Ian

___
OpenStack-dev mailing list
OpenStack-dev@lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev


--
Thanks,
Eli (Li Yong) Qiao

___
OpenStack-dev mailing list
OpenStack-dev@lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev


Re: [openstack-dev] [Nova] [All] API standards working group

2014-09-24 Thread Christopher Yeoh
On Wed, 24 Sep 2014 16:48:43 +
Everett Toews everett.to...@rackspace.com wrote:

 On Sep 24, 2014, at 9:42 AM, Dean Troyer dtro...@gmail.com wrote:
 
  I'll bring an API consumer's perspective.  
 
 +1
 
 I’d bring an API consumer’s perspective as well.
 
 Looks like there’s lots of support for an API WG. What’s the next
 step?

We have the start of some guidelines here:

https://wiki.openstack.org/wiki/Governance/Proposed/APIGuidelines

I think it would be very useful if those who are interested in helping
out add info to that wiki from the perspective of the project they work
on and comment (inline) where what is already there is inconsistent with
what they do. User input too as to what they want would be useful. 

That would give us something much more concrete to discuss and debate
rather than just a common desire to have consistency across our APIs.

Regards,

Chris

___
OpenStack-dev mailing list
OpenStack-dev@lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev


Re: [openstack-dev] [Nova] [All] API standards working group

2014-09-24 Thread Kenichi Oomichi
 -Original Message-
 From: Christopher Yeoh [mailto:cbky...@gmail.com]
 Sent: Thursday, September 25, 2014 12:32 PM
 To: OpenStack Development Mailing List (not for usage questions)
 Subject: Re: [openstack-dev] [Nova] [All] API standards working group
 
 On Wed, 24 Sep 2014 16:48:43 +
 Everett Toews everett.to...@rackspace.com wrote:
 
  On Sep 24, 2014, at 9:42 AM, Dean Troyer dtro...@gmail.com wrote:
 
   I'll bring an API consumer's perspective.
 
  +1
 
  I’d bring an API consumer’s perspective as well.
 
  Looks like there’s lots of support for an API WG. What’s the next
  step?
 
 We have the start of some guidelines here:
 
 https://wiki.openstack.org/wiki/Governance/Proposed/APIGuidelines
 
 I think it would be very useful if those who are interested in helping
 out add info to that wiki from the perspective of the project they work
 on and comment (inline) where what is already there is inconsistent with
 what they do. User input too as to what they want would be useful.
 
 That would give us something much more concrete to discuss and debate
 rather than just a common desire to have consistency across our APIs.

The wiki is good for the complete document, but it seems a little difficult
to discuss API consistency.
So how about using gerrit for this discussion like specs?

Thanks
Ken'ichi Ohmichi

___
OpenStack-dev mailing list
OpenStack-dev@lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev


Re: [openstack-dev] [Nova] [All] API standards working group

2014-09-24 Thread Christopher Yeoh
On Wed, 24 Sep 2014 13:05:09 -0400
Jay Pipes jaypi...@gmail.com wrote:

 On 09/24/2014 12:48 PM, Everett Toews wrote:
  On Sep 24, 2014, at 9:42 AM, Dean Troyer dtro...@gmail.com wrote:
 
  I'll bring an API consumer's perspective.
 
  +1
 
  I’d bring an API consumer’s perspective as well.
 
  Looks like there’s lots of support for an API WG. What’s the next
  step?
 
  Form a WG under the User Committee [1] or is there something more
  appropriate?
 
  Thanks,
  Everett
 
  [1]
  https://wiki.openstack.org/wiki/Governance/Foundation/UserCommittee#Working_Groups
 
 Whatever it ends up being, it needs to have some teeth to it.
 Otherwise, we're going to end up in the exact same place we're in
 now, where each project does something slightly different.

I think its more an issue around actually having guidelines and
educating people where to find them than needing teeth to enforce them.
Where I've seen variation in the APIs in Nova its been primarily because
people haven't known what the conventions are than anything else. 

Chris

___
OpenStack-dev mailing list
OpenStack-dev@lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev


Re: [openstack-dev] [Nova] [All] API standards working group

2014-09-24 Thread Anne Gentle
On Wed, Sep 24, 2014 at 10:51 PM, Christopher Yeoh cbky...@gmail.com
wrote:

 On Wed, 24 Sep 2014 13:05:09 -0400
 Jay Pipes jaypi...@gmail.com wrote:

  On 09/24/2014 12:48 PM, Everett Toews wrote:
   On Sep 24, 2014, at 9:42 AM, Dean Troyer dtro...@gmail.com wrote:
  
   I'll bring an API consumer's perspective.
  
   +1
  
   I’d bring an API consumer’s perspective as well.
  
   Looks like there’s lots of support for an API WG. What’s the next
   step?
  
   Form a WG under the User Committee [1] or is there something more
   appropriate?
  
   Thanks,
   Everett
  
   [1]
  
 https://wiki.openstack.org/wiki/Governance/Foundation/UserCommittee#Working_Groups
 
  Whatever it ends up being, it needs to have some teeth to it.
  Otherwise, we're going to end up in the exact same place we're in
  now, where each project does something slightly different.

 I think its more an issue around actually having guidelines and
 educating people where to find them than needing teeth to enforce them.
 Where I've seen variation in the APIs in Nova its been primarily because
 people haven't known what the conventions are than anything else.


+1

I think the wiki is a great place to get ideas out while we look for a
cross-project specs workflow in the meantime. Here's a link to the TC
meeting [1] where we talked about creating a style guide similar to this
one:

http://fedoraproject.org/wiki/Cloud_APIs_REST_Style_Guide

The goal is to give developers guidance while designing APIs so we're
consistent across all the projects. If we don't get this sort of style guide
to point people to, we'll continue to experience inconsistency across
projects. Let's start on the wiki, talk more at the Summit, and iterate as
we go.

Anne

1.
http://eavesdrop.openstack.org/meetings/tc/2014/tc.2014-06-10-20.03.log.html




 Chris

 ___
 OpenStack-dev mailing list
 OpenStack-dev@lists.openstack.org
 http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev

___
OpenStack-dev mailing list
OpenStack-dev@lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev


Re: [openstack-dev] [Nova] [All] API standards working group (was: Some ideas for micro-version implementation)

2014-09-23 Thread Rochelle.RochelleGrober




jaypi...@gmail.commailto:jaypi...@gmail.com on Tuesday, September 23, 2014 
9:09 AM wrote:


_Snip



I'd like to say finally that I think there should be an OpenStack API

working group whose job it is to both pull together a set of OpenStack

API practices as well as evaluate new REST APIs proposed in the

OpenStack ecosystem to provide guidance to new projects or new

subprojects wishing to add resources to an existing REST API.



Best,

-jay



[Rocky Grober] ++

Jay, are you volunteering to head up the working group? Or at least be an 
active member?  I'll certainly follow with interest, but I think I have my 
hands full with the log rationalization working group.



--Rocky
___
OpenStack-dev mailing list
OpenStack-dev@lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev


Re: [openstack-dev] [Nova] [All] API standards working group

2014-09-23 Thread Jay Pipes

On 09/23/2014 05:03 PM, Rochelle.RochelleGrober wrote:

jaypi...@gmail.com mailto:jaypi...@gmail.com on Tuesday, September 23,
2014 9:09 AM wrote:

_Snip

I'd like to say finally that I think there should be an OpenStack API

working group whose job it is to both pull together a set of OpenStack

API practices as well as evaluate new REST APIs proposed in the

OpenStack ecosystem to provide guidance to new projects or new

subprojects wishing to add resources to an existing REST API.

Best,

-jay

*/[Rocky Grober] /*++

*/Jay, are you volunteering to head up the working group? Or at least be
an active member?  I’ll certainly follow with interest, but I think I
have my hands full with the log rationalization working group./*


Yes, I'd be willing to head up the working group... or at least 
participate in it.


Best,
-jay

___
OpenStack-dev mailing list
OpenStack-dev@lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev


Re: [openstack-dev] [Nova] [All] API standards working group

2014-09-23 Thread Dolph Mathews
I'd be interested in participating in this as well.

I wrote Keystone's v3 Identity API Document Overview and Conventions [1]
with an eye toward hopefully establishing *some* consistency across
multiple projects (or at least having a starting ground with which to
discuss and iterate on).

[1]
https://github.com/openstack/identity-api/blob/master/v3/src/markdown/identity-api-v3.md#document-overview
On Sep 23, 2014 6:22 PM, Jay Pipes jaypi...@gmail.com wrote:

 On 09/23/2014 05:03 PM, Rochelle.RochelleGrober wrote:

 jaypi...@gmail.com mailto:jaypi...@gmail.com on Tuesday, September 23,
 2014 9:09 AM wrote:

 _Snip

 I'd like to say finally that I think there should be an OpenStack API

 working group whose job it is to both pull together a set of OpenStack

 API practices as well as evaluate new REST APIs proposed in the

 OpenStack ecosystem to provide guidance to new projects or new

 subprojects wishing to add resources to an existing REST API.

 Best,

 -jay

 */[Rocky Grober] /*++

 */Jay, are you volunteering to head up the working group? Or at least be
 an active member?  I’ll certainly follow with interest, but I think I
 have my hands full with the log rationalization working group./*


 Yes, I'd be willing to head up the working group... or at least
 participate in it.

 Best,
 -jay

 ___
 OpenStack-dev mailing list
 OpenStack-dev@lists.openstack.org
 http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev

___
OpenStack-dev mailing list
OpenStack-dev@lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev


Re: [openstack-dev] [Nova] [All] API standards working group

2014-09-23 Thread Morgan Fainberg
-Original Message-
From: Dolph Mathews dolph.math...@gmail.com
Reply: OpenStack Development Mailing List (not for usage questions) 
openstack-dev@lists.openstack.org
Date: September 23, 2014 at 16:41:27
To: OpenStack Development Mailing List openstack-dev@lists.openstack.org
Subject:  Re: [openstack-dev] [Nova] [All] API standards working group

 I'd be interested in participating in this as well.
  
 I wrote Keystone's v3 Identity API Document Overview and Conventions [1]
 with an eye toward hopefully establishing *some* consistency across
 multiple projects (or at least having a starting ground with which to
 discuss and iterate on).
  
 [1]
 https://github.com/openstack/identity-api/blob/master/v3/src/markdown/identity-api-v3.md#document-overview
   
 On Sep 23, 2014 6:22 PM, Jay Pipes wrote:
  
  On 09/23/2014 05:03 PM, Rochelle.RochelleGrober wrote:
 
  jaypi...@gmail.com on Tuesday, September 23,
  2014 9:09 AM wrote:
 
  _Snip
 
  I'd like to say finally that I think there should be an OpenStack API
 
  working group whose job it is to both pull together a set of OpenStack
 
  API practices as well as evaluate new REST APIs proposed in the
 
  OpenStack ecosystem to provide guidance to new projects or new
 
  subprojects wishing to add resources to an existing REST API.
 
  Best,
 
  -jay
 
  */[Rocky Grober] /*++
 
  */Jay, are you volunteering to head up the working group? Or at least be
  an active member? I’ll certainly follow with interest, but I think I
  have my hands full with the log rationalization working group./*
 
 
  Yes, I'd be willing to head up the working group... or at least
  participate in it.
 
  Best,
  -jay

I would also be interested in participating in on this front.

—Morgan

___
OpenStack-dev mailing list
OpenStack-dev@lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev


Re: [openstack-dev] [Nova] [All] API standards working group

2014-09-23 Thread Christopher Yeoh
On Tue, 23 Sep 2014 18:18:56 -0400
Jay Pipes jaypi...@gmail.com wrote:

 On 09/23/2014 05:03 PM, Rochelle.RochelleGrober wrote:
  jaypi...@gmail.com mailto:jaypi...@gmail.com on Tuesday,
  September 23, 2014 9:09 AM wrote:
 
  _Snip
 
  I'd like to say finally that I think there should be an OpenStack
  API
 
  working group whose job it is to both pull together a set of
  OpenStack
 
  API practices as well as evaluate new REST APIs proposed in the
 
  OpenStack ecosystem to provide guidance to new projects or new
 
  subprojects wishing to add resources to an existing REST API.
 
  Best,
 
  -jay
 
  */[Rocky Grober] /*++
 
  */Jay, are you volunteering to head up the working group? Or at
  least be an active member?  I’ll certainly follow with interest,
  but I think I have my hands full with the log rationalization
  working group./*
 
 Yes, I'd be willing to head up the working group... or at least 
 participate in it.


I'd be very interested in participating as well.

At the last Design Summit at the cross project API consistency session
we talked about setting up a wiki page for guidelines. I've made a
start on this though its very much from a Nova perspective and could
do with input from all the other projects.

https://wiki.openstack.org/wiki/Governance/Proposed/APIGuidelines

Chris

___
OpenStack-dev mailing list
OpenStack-dev@lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev