Re: [openstack-dev] [api] API Workgroup git repository

2014-10-23 Thread Christopher Yeoh
On Thu, 23 Oct 2014 05:53:21 +
Shaunak Kashyap shaunak.kash...@rackspace.com wrote:

 Thanks Chris. And am I correct in assuming that no weekly api-wg
 meetings are currently going on? I don’t see anything here anyway:
 https://wiki.openstack.org/wiki/Meetings.
 

They haven't started yet. Not sure if we'll be squeezing one in before
summit or not. The proposed meeting time patch only just recently
merged (Thursdays UTC )

https://review.openstack.org/#/c/128332/2

so perhaps thats why its not there yet.

Chris

 Shaunak
 
 On Oct 22, 2014, at 10:39 PM, Christopher Yeoh
 cbky...@gmail.commailto:cbky...@gmail.com wrote:
 
 On Thu, Oct 23, 2014 at 3:51 PM, Shaunak Kashyap
 shaunak.kash...@rackspace.commailto:shaunak.kash...@rackspace.com
 wrote: If I have a proposal to make for a guideline, how do I do it?
 Do I simply create a gerrit review for a file under
 http://git.openstack.org/cgit/openstack/api-wg/tree/guidelines?
 
 
 Yes, either additions to the existing files or add new ones if there
 is nothing currently appropriate.
 
 We still need to talk about the exact process for accepting a patch
 yet, but I was thinking about something along the lines of (and
 haven't really discussed it with anyone yet):
 
 - must be up for at least a week
 - discussed at a weekly api-wg meeting
 - no more than one negative vote (ok we might need something to break
   a deadlock if we really can't get consensus over something but
   I think there should be a lot of incentive to try very hard
   to do so).
 
 Though for now any setup work in the repository is getting approved
 by Jay or I if it looks reasonable.
 
 Chris
 
 
 Shaunak
 
 On Oct 22, 2014, at 3:34 PM, Christopher Yeoh
 cbky...@gmail.commailto:cbky...@gmail.com wrote:
 
  On Wed, 22 Oct 2014 20:36:27 +
  Everett Toews
  everett.to...@rackspace.commailto:everett.to...@rackspace.com
  wrote:
 
  I notice at the top of the GitHub mirror page [1] it reads, API
  Working Group http://openstack.orghttp://openstack.org/”
 
  Can we get that changed to API Working Group
  https://wiki.openstack.org/wiki/API_Working_Group”?
 
  That URL would be much more helpful to people who come across the
  GitHub repo. It's not a code change so we would need a repo owner
  to actually make the change. Who should I contact about that?
 
  I think this will do it:
 
  https://review.openstack.org/130377
 
  Chris
 
 
  ___
  OpenStack-dev mailing list
  OpenStack-dev@lists.openstack.orgmailto:OpenStack-dev@lists.openstack.org
  http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
 
 
 ___
 OpenStack-dev mailing list
 OpenStack-dev@lists.openstack.orgmailto:OpenStack-dev@lists.openstack.org
 http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
 
 ___
 OpenStack-dev mailing list
 OpenStack-dev@lists.openstack.orgmailto: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] [api] API Workgroup git repository

2014-10-22 Thread Stefano Maffulli
Hi Chris

On 10/21/2014 11:08 PM, Christopher Yeoh wrote:
 The API Workgroup git repository has been setup and you can access it
 here.
Cool, adding it to the repos to watch. 
 There is some content there though not all the proposed guidelines from
 the wiki page are in yet:

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

I think that as soon as possible the wiki pages should be deleted and 
redirected to wherever the wg will publish the authoritative content. The wiki 
gets lots of traffic from web searches and stale content there really hurts us.

Where is the content going to live?

/stef

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


Re: [openstack-dev] [api] API Workgroup git repository

2014-10-22 Thread Steve Martinelli
we could set up a job to publish under docs.o.org/api-wg pretty easily - 
it seems like a good place to start to publish this content.

thanks for getting the repo all setup chris and jay.


Thanks,

_
Steve Martinelli
OpenStack Development - Keystone Core Member
Phone: (905) 413-2851
E-Mail: steve...@ca.ibm.com



From:   Stefano Maffulli stef...@openstack.org
To: OpenStack Development Mailing List (not for usage questions) 
openstack-dev@lists.openstack.org, 
Date:   10/22/2014 03:22 PM
Subject:Re: [openstack-dev] [api] API Workgroup git repository



Hi Chris

On 10/21/2014 11:08 PM, Christopher Yeoh wrote:
 The API Workgroup git repository has been setup and you can access it
 here.
Cool, adding it to the repos to watch. 
 There is some content there though not all the proposed guidelines from
 the wiki page are in yet:

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

I think that as soon as possible the wiki pages should be deleted and 
redirected to wherever the wg will publish the authoritative content. The 
wiki gets lots of traffic from web searches and stale content there really 
hurts us.

Where is the content going to live?

/stef

___
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] [api] API Workgroup git repository

2014-10-22 Thread Anne Gentle
On Wed, Oct 22, 2014 at 2:26 PM, Steve Martinelli steve...@ca.ibm.com
wrote:

 we could set up a job to publish under docs.o.org/api-wg pretty easily -
 it seems like a good place to start to publish this content.

 thanks for getting the repo all setup chris and jay.


Thanks for setting up the repo.

We probably want it to go to docs.openstack.org/developer/api-wg and link
to it from here:

http://docs.openstack.org/developer/openstack-projects.html

Anne



 Thanks,

 _
 Steve Martinelli
 OpenStack Development - Keystone Core Member
 Phone: (905) 413-2851
 E-Mail: steve...@ca.ibm.com



 From:Stefano Maffulli stef...@openstack.org
 To:OpenStack Development Mailing List (not for usage questions)
 openstack-dev@lists.openstack.org,
 Date:10/22/2014 03:22 PM
 Subject:Re: [openstack-dev] [api] API Workgroup git repository
 --



 Hi Chris

 On 10/21/2014 11:08 PM, Christopher Yeoh wrote:
  The API Workgroup git repository has been setup and you can access it
  here.
 Cool, adding it to the repos to watch.
  There is some content there though not all the proposed guidelines from
  the wiki page are in yet:
 
  https://wiki.openstack.org/wiki/Governance/Proposed/APIGuidelines

 I think that as soon as possible the wiki pages should be deleted and
 redirected to wherever the wg will publish the authoritative content. The
 wiki gets lots of traffic from web searches and stale content there really
 hurts us.

 Where is the content going to live?

 /stef

 ___
 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


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


Re: [openstack-dev] [api] API Workgroup git repository

2014-10-22 Thread Everett Toews
I notice at the top of the GitHub mirror page [1] it reads, API Working Group 
http://openstack.org”

Can we get that changed to API Working Group 
https://wiki.openstack.org/wiki/API_Working_Group”?

That URL would be much more helpful to people who come across the GitHub repo. 
It's not a code change so we would need a repo owner to actually make the 
change. Who should I contact about that?

Thanks,
Everett

[1] https://github.com/openstack/api-wg/


On Oct 22, 2014, at 1:08 AM, Christopher Yeoh cbky...@gmail.com wrote:

 Hi,
 
 The API Workgroup git repository has been setup and you can access it
 here.
 
 http://git.openstack.org/cgit/openstack/api-wg/
 
 There is some content there though not all the proposed guidelines from
 the wiki page are in yet:
 
 https://wiki.openstack.org/wiki/Governance/Proposed/APIGuidelines
 
 Please feel free to start submitting patches to the document.
 
 I have submitted a patch to convert the initial content from markdown to
 rst and setup the tox targets to produce an html document. Seemed to be
 an easier route as it seems to be the preferred format for OpenStack
 projects and we can just copy all the build/check bits from the specs
 repositories. Also doesn't require any changes to required packages.
 
 https://review.openstack.org/130120
 
 Until this is merged its probably better to base any patches on this
 one.
 
 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] [api] API Workgroup git repository

2014-10-22 Thread Clark Boylan
It is a code change :) Everything is a code change around here. You will
want to update the projects.yaml file in openstack-infra/project-config
[0]. If you add a 'homepage:
https://wiki.openstack.org/wiki/API_Working_Group' key value pair to the
api-wg dict there the jeepyb tooling should update the project homepage
in github for you. If it doesn't then we probably have a bug somewhere
and that should be fixed.

[0]
https://git.openstack.org/cgit/openstack-infra/project-config/tree/gerrit/projects.yaml#n287

All that said, we really try to downplay the importance of github as
well. It is a mirror for us, but it is a discoverable mirror so updating
the 'homepage' is probably a reasonable thing to do.

Clark

On Wed, Oct 22, 2014, at 01:36 PM, Everett Toews wrote:
 I notice at the top of the GitHub mirror page [1] it reads, API Working
 Group http://openstack.org”
 
 Can we get that changed to API Working Group
 https://wiki.openstack.org/wiki/API_Working_Group”?
 
 That URL would be much more helpful to people who come across the GitHub
 repo. It's not a code change so we would need a repo owner to actually
 make the change. Who should I contact about that?
 
 Thanks,
 Everett
 
 [1] https://github.com/openstack/api-wg/
 
 
 On Oct 22, 2014, at 1:08 AM, Christopher Yeoh cbky...@gmail.com wrote:
 
  Hi,
  
  The API Workgroup git repository has been setup and you can access it
  here.
  
  http://git.openstack.org/cgit/openstack/api-wg/
  
  There is some content there though not all the proposed guidelines from
  the wiki page are in yet:
  
  https://wiki.openstack.org/wiki/Governance/Proposed/APIGuidelines
  
  Please feel free to start submitting patches to the document.
  
  I have submitted a patch to convert the initial content from markdown to
  rst and setup the tox targets to produce an html document. Seemed to be
  an easier route as it seems to be the preferred format for OpenStack
  projects and we can just copy all the build/check bits from the specs
  repositories. Also doesn't require any changes to required packages.
  
  https://review.openstack.org/130120
  
  Until this is merged its probably better to base any patches on this
  one.
  
  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

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


Re: [openstack-dev] [api] API Workgroup git repository

2014-10-22 Thread Steve Martinelli
Everett, I think the description is managed by this file: 
https://github.com/openstack-infra/project-config/blob/master/gerrit/projects.yaml

- Steve



From:   Everett Toews everett.to...@rackspace.com
To: OpenStack Development Mailing List (not for usage questions) 
openstack-dev@lists.openstack.org, 
Date:   10/22/2014 04:40 PM
Subject:Re: [openstack-dev] [api] API Workgroup git repository



I notice at the top of the GitHub mirror page [1] it reads, API Working 
Group http://openstack.org?

Can we get that changed to API Working Group 
https://wiki.openstack.org/wiki/API_Working_Group??

That URL would be much more helpful to people who come across the GitHub 
repo. It's not a code change so we would need a repo owner to actually 
make the change. Who should I contact about that?

Thanks,
Everett

[1] https://github.com/openstack/api-wg/


On Oct 22, 2014, at 1:08 AM, Christopher Yeoh cbky...@gmail.com wrote:

 Hi,
 
 The API Workgroup git repository has been setup and you can access it
 here.
 
 http://git.openstack.org/cgit/openstack/api-wg/
 
 There is some content there though not all the proposed guidelines from
 the wiki page are in yet:
 
 https://wiki.openstack.org/wiki/Governance/Proposed/APIGuidelines
 
 Please feel free to start submitting patches to the document.
 
 I have submitted a patch to convert the initial content from markdown to
 rst and setup the tox targets to produce an html document. Seemed to be
 an easier route as it seems to be the preferred format for OpenStack
 projects and we can just copy all the build/check bits from the specs
 repositories. Also doesn't require any changes to required packages.
 
 https://review.openstack.org/130120
 
 Until this is merged its probably better to base any patches on this
 one.
 
 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


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


Re: [openstack-dev] [api] API Workgroup git repository

2014-10-22 Thread Christopher Yeoh
On Wed, 22 Oct 2014 14:44:26 -0500
Anne Gentle a...@openstack.org wrote:

 On Wed, Oct 22, 2014 at 2:26 PM, Steve Martinelli
 steve...@ca.ibm.com wrote:
 
  we could set up a job to publish under docs.o.org/api-wg pretty
  easily - it seems like a good place to start to publish this
  content.
 
  thanks for getting the repo all setup chris and jay.
 
 
 Thanks for setting up the repo.
 
 We probably want it to go to docs.openstack.org/developer/api-wg and
 link to it from here:
 
 http://docs.openstack.org/developer/openstack-projects.html


That sounds good to me. Steve has a proposed patch we can use here:

https://review.openstack.org/#/c/130363/

I'm not sure of the syntax myself (I had a bit of a look into it last
night)

Chris

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


Re: [openstack-dev] [api] API Workgroup git repository

2014-10-22 Thread Christopher Yeoh
On Wed, 22 Oct 2014 20:36:27 +
Everett Toews everett.to...@rackspace.com wrote:

 I notice at the top of the GitHub mirror page [1] it reads, API
 Working Group http://openstack.org”
 
 Can we get that changed to API Working Group
 https://wiki.openstack.org/wiki/API_Working_Group”?
 
 That URL would be much more helpful to people who come across the
 GitHub repo. It's not a code change so we would need a repo owner to
 actually make the change. Who should I contact about that?

I think this will do it:

https://review.openstack.org/130377

Chris


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


Re: [openstack-dev] [api] API Workgroup git repository

2014-10-22 Thread Shaunak Kashyap
If I have a proposal to make for a guideline, how do I do it? Do I simply 
create a gerrit review for a file under 
http://git.openstack.org/cgit/openstack/api-wg/tree/guidelines?

Shaunak

On Oct 22, 2014, at 3:34 PM, Christopher Yeoh cbky...@gmail.com wrote:

 On Wed, 22 Oct 2014 20:36:27 +
 Everett Toews everett.to...@rackspace.com wrote:
 
 I notice at the top of the GitHub mirror page [1] it reads, API
 Working Group http://openstack.org”
 
 Can we get that changed to API Working Group
 https://wiki.openstack.org/wiki/API_Working_Group”?
 
 That URL would be much more helpful to people who come across the
 GitHub repo. It's not a code change so we would need a repo owner to
 actually make the change. Who should I contact about that?
 
 I think this will do it:
 
 https://review.openstack.org/130377
 
 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] [api] API Workgroup git repository

2014-10-22 Thread Christopher Yeoh
On Thu, Oct 23, 2014 at 3:51 PM, Shaunak Kashyap 
shaunak.kash...@rackspace.com wrote:

 If I have a proposal to make for a guideline, how do I do it? Do I simply
 create a gerrit review for a file under
 http://git.openstack.org/cgit/openstack/api-wg/tree/guidelines?


Yes, either additions to the existing files or add new ones if there is
nothing currently appropriate.

We still need to talk about the exact process for accepting a patch yet,
but I was thinking about something along the lines of (and haven't really
discussed it with anyone yet):

- must be up for at least a week
- discussed at a weekly api-wg meeting
- no more than one negative vote (ok we might need something to break
  a deadlock if we really can't get consensus over something but
  I think there should be a lot of incentive to try very hard
  to do so).

Though for now any setup work in the repository is getting approved by Jay
or I if it looks reasonable.

Chris



 Shaunak

 On Oct 22, 2014, at 3:34 PM, Christopher Yeoh cbky...@gmail.com wrote:

  On Wed, 22 Oct 2014 20:36:27 +
  Everett Toews everett.to...@rackspace.com wrote:
 
  I notice at the top of the GitHub mirror page [1] it reads, API
  Working Group http://openstack.org”
 
  Can we get that changed to API Working Group
  https://wiki.openstack.org/wiki/API_Working_Group”?
 
  That URL would be much more helpful to people who come across the
  GitHub repo. It's not a code change so we would need a repo owner to
  actually make the change. Who should I contact about that?
 
  I think this will do it:
 
  https://review.openstack.org/130377
 
  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

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


Re: [openstack-dev] [api] API Workgroup git repository

2014-10-22 Thread Shaunak Kashyap
Thanks Chris. And am I correct in assuming that no weekly api-wg meetings are 
currently going on? I don’t see anything here anyway: 
https://wiki.openstack.org/wiki/Meetings.

Shaunak

On Oct 22, 2014, at 10:39 PM, Christopher Yeoh 
cbky...@gmail.commailto:cbky...@gmail.com wrote:

On Thu, Oct 23, 2014 at 3:51 PM, Shaunak Kashyap 
shaunak.kash...@rackspace.commailto:shaunak.kash...@rackspace.com wrote:
If I have a proposal to make for a guideline, how do I do it? Do I simply 
create a gerrit review for a file under 
http://git.openstack.org/cgit/openstack/api-wg/tree/guidelines?


Yes, either additions to the existing files or add new ones if there is nothing 
currently appropriate.

We still need to talk about the exact process for accepting a patch yet, but I 
was thinking about something along the lines of (and haven't really discussed 
it with anyone yet):

- must be up for at least a week
- discussed at a weekly api-wg meeting
- no more than one negative vote (ok we might need something to break
  a deadlock if we really can't get consensus over something but
  I think there should be a lot of incentive to try very hard
  to do so).

Though for now any setup work in the repository is getting approved by Jay or I 
if it looks reasonable.

Chris


Shaunak

On Oct 22, 2014, at 3:34 PM, Christopher Yeoh 
cbky...@gmail.commailto:cbky...@gmail.com wrote:

 On Wed, 22 Oct 2014 20:36:27 +
 Everett Toews 
 everett.to...@rackspace.commailto:everett.to...@rackspace.com wrote:

 I notice at the top of the GitHub mirror page [1] it reads, API
 Working Group http://openstack.orghttp://openstack.org/”

 Can we get that changed to API Working Group
 https://wiki.openstack.org/wiki/API_Working_Group”?

 That URL would be much more helpful to people who come across the
 GitHub repo. It's not a code change so we would need a repo owner to
 actually make the change. Who should I contact about that?

 I think this will do it:

 https://review.openstack.org/130377

 Chris


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


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

___
OpenStack-dev mailing list
OpenStack-dev@lists.openstack.orgmailto: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