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

[Christopher Yeoh]

On Thu, 23 Oct 2014 05:53:21 +
Shaunak Kashyap  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
> mailto:cbky...@gmail.com>> wrote:
> 
> On Thu, Oct 23, 2014 at 3:51 PM, Shaunak Kashyap
> mailto: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
> mailto:cbky...@gmail.com>> wrote:
> 
> > On Wed, 22 Oct 2014 20:36:27 +
> > Everett Toews
> > mailto: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
> 


___
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

[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 
mailto:cbky...@gmail.com>> wrote:

On Thu, Oct 23, 2014 at 3:51 PM, Shaunak Kashyap 
mailto: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 
mailto:cbky...@gmail.com>> wrote:

> On Wed, 22 Oct 2014 20:36:27 +
> Everett Toews 
> mailto: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

___
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

[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  wrote:
>
> > On Wed, 22 Oct 2014 20:36:27 +
> > 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?
> >
> > 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

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

> On Wed, 22 Oct 2014 20:36:27 +
> 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?
> 
> 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

[Christopher Yeoh]

On Wed, 22 Oct 2014 20:36:27 +
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?

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

[Christopher Yeoh]

On Wed, 22 Oct 2014 14:44:26 -0500
Anne Gentle  wrote:

> On Wed, Oct 22, 2014 at 2:26 PM, Steve Martinelli
>  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

[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 
To: "OpenStack Development Mailing List (not for usage questions)" 
, 
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  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

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

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

[Anne Gentle]

On Wed, Oct 22, 2014 at 2:26 PM, Steve Martinelli 
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 
> To:"OpenStack Development Mailing List (not for usage questions)"
> ,
> 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

[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 
To: "OpenStack Development Mailing List (not for usage questions)" 
, 
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

[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

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

[Christopher Yeoh]

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