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

[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  wrote:

> On Sep 24, 2014, at 9:42 AM, Dean Troyer  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

[Anne Gentle]

On Wed, Sep 24, 2014 at 10:51 PM, Christopher Yeoh 
wrote:

> On Wed, 24 Sep 2014 13:05:09 -0400
> Jay Pipes  wrote:
>
> > On 09/24/2014 12:48 PM, Everett Toews wrote:
> > > On Sep 24, 2014, at 9:42 AM, Dean Troyer  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

[Christopher Yeoh]

On Wed, 24 Sep 2014 13:05:09 -0400
Jay Pipes  wrote:

> On 09/24/2014 12:48 PM, Everett Toews wrote:
> > On Sep 24, 2014, at 9:42 AM, Dean Troyer  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

[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  wrote:
> 
> > On Sep 24, 2014, at 9:42 AM, Dean Troyer  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

[Christopher Yeoh]

On Wed, 24 Sep 2014 16:48:43 +
Everett Toews  wrote:

> On Sep 24, 2014, at 9:42 AM, Dean Troyer  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

[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"  wrote:


You can add me to this list as well.


Thanks!


Lance


On Wed, Sep 24, 2014 at 9:41 AM, Alex Xu
 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
 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

[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  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
>
> ___
> 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

[Everett Toews]

On Sep 24, 2014, at 12:02 PM, Tim Bell  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

[Chmouel Boudjnah]

On Wed, Sep 24, 2014 at 12:18 AM, Jay Pipes  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

[Carl Baldwin]

On Wed, Sep 24, 2014 at 11:05 AM, David Stanek  wrote:
>
>
> On Wed, Sep 24, 2014 at 11:42 AM, Dean Troyer  wrote:
>>
>> On Tue, Sep 23, 2014 at 5:18 PM, Jay Pipes  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

[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

[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  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

[Jay Pipes]

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

On Sep 24, 2014, at 9:42 AM, Dean Troyer  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

[David Stanek]

On Wed, Sep 24, 2014 at 11:42 AM, Dean Troyer  wrote:

> On Tue, Sep 23, 2014 at 5:18 PM, Jay Pipes  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

[Everett Toews]

On Sep 24, 2014, at 9:42 AM, Dean Troyer  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

[Dean Troyer]

On Tue, Sep 23, 2014 at 5:18 PM, Jay Pipes  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

[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 
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

[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 
To: Dolph Mathews , "OpenStack Development 
Mailing List (not for usage questions)" 
, 
Date:   09/23/2014 08:01 PM
Subject:    Re: [openstack-dev] [Nova] [All] API standards working 
group



-Original Message-
From: Dolph Mathews 
Reply: OpenStack Development Mailing List (not for usage questions) 
>
Date: September 23, 2014 at 16:41:27
To: OpenStack Development Mailing List 
>
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

[Ian Cordasco]

On 9/24/14, 9:51 AM, "Lance Bragstad"  wrote:

>You can add me to this list as well.
>
>
>Thanks! 
>
>
>Lance
>
>
>On Wed, Sep 24, 2014 at 9:41 AM, Alex Xu
> 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
> 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

[Lance Bragstad]

You can add me to this list as well.

Thanks!

Lance

On Wed, Sep 24, 2014 at 9:41 AM, Alex Xu  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 
> 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

[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  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 
> 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 

___
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

[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 <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

[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 
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

[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

[Christopher Yeoh]

On Tue, 23 Sep 2014 18:18:56 -0400
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.


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

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

[Morgan Fainberg]

-Original Message-
From: Dolph Mathews 
Reply: OpenStack Development Mailing List (not for usage questions) 
>
Date: September 23, 2014 at 16:41:27
To: OpenStack Development Mailing List >
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

[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"  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
>
> ___
> 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

[Jay Pipes]

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

___
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)

[Rochelle.RochelleGrober]

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