Re: [openstack-dev] [all] specs.openstack.org is live

2014-08-05 Thread Carl Baldwin
I have a spec proposal in play that crosses the Nova/Neutron boundary.
I split it in to two specs:  a nova spec [1] and a Neutron spec [2].
There is a little duplication between the two at a high level but not
in the details.  Each of the specs references the other at various
spots in the text and in the references section.

This isn't the optimal way to write a cross-project spec.  There is
difficulty involved in keeping the two consistent.  Also, reviewers
from one program often don't bother to read the spec from the other.
This is unfortunate.

However, given the constraints of the current process, I believe that
it was necessary to split the spec in to two so that the cores
responsible for each program review and accept the design for the
proposed changes in their realm.

Would it make more sense to submit the exact same monolithic
specification to both?  At the time, I chose against it because I
thought it would make it more difficult to read in the context of a
single program.

I'm open and looking forward to hearing others' thoughts on this.

Carl

[1] https://review.openstack.org/#/c/90150/
[2] https://review.openstack.org/#/c/88623/

On Mon, Aug 4, 2014 at 8:33 PM, Jeremy Stanley fu...@yuggoth.org wrote:
 On 2014-08-05 01:26:49 + (+), joehuang wrote:
 I would like to know how to submit cross project spec? Is there a
 repository for cross project cross project spec.

 Specs repositories are about formalizing/streamlining the design
 process within a program, and generally the core reviewers of those
 programs decide when a spec is in a suitable condition for approval.
 In the case of a cross-program spec (which I assume is what you mean
 by cross-project), who would decide what needs to be in the spec
 proposal and who would approve it? What sort of design proposal do
 you have in mind which you think would need to be a single spec
 applying to projects in more than one program?
 --
 Jeremy Stanley

 ___
 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] [all] specs.openstack.org is live

2014-08-05 Thread Devananda van der Veen
This is great, thanks to everyone who helped make it happen!

-D


On Sat, Aug 2, 2014 at 10:16 AM, Andreas Jaeger a...@suse.com wrote:

 All OpenStack incubated projects and programs that use a -specs
 repository have now been setup to publish these to
 http://specs.openstack.org. With the next merged in patch of a *-specs
 repository, the documentation will get published.

 The index page contains the published repos as of yesterday and it will
 be enhanced as more are setup (current patch:
 https://review.openstack.org/111476).

 For now, you can reach a repo directly via
 http://specs.openstack.org/$ORGANIZATION/$project-specs, for example:
 http://specs.openstack.org/openstack/qa-specs/

 Thanks to Steve Martinelli and to the infra team (especially Clark,
 James, Jeremy and Sergey) for getting this done!

 Andreas
 --
  Andreas Jaeger aj@{suse.com,opensuse.org} Twitter/Identica: jaegerandi
   SUSE LINUX Products GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
GF: Jeff Hawn,Jennifer Guild,Felix Imendörffer,HRB16746 (AG Nürnberg)
 GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126

 ___
 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] [all] specs.openstack.org is live

2014-08-05 Thread Joe Gordon
On Aug 6, 2014 2:49 AM, Carl Baldwin c...@ecbaldwin.net wrote:

 I have a spec proposal in play that crosses the Nova/Neutron boundary.
 I split it in to two specs:  a nova spec [1] and a Neutron spec [2].
 There is a little duplication between the two at a high level but not
 in the details.  Each of the specs references the other at various
 spots in the text and in the references section.

 This isn't the optimal way to write a cross-project spec.  There is
 difficulty involved in keeping the two consistent.  Also, reviewers
 from one program often don't bother to read the spec from the other.
 This is unfortunate.

 However, given the constraints of the current process, I believe that
 it was necessary to split the spec in to two so that the cores
 responsible for each program review and accept the design for the
 proposed changes in their realm.

 Would it make more sense to submit the exact same monolithic
 specification to both?  At the time, I chose against it because I
 thought it would make it more difficult to read in the context of a
 single program.

 I'm open and looking forward to hearing others' thoughts on this.


While I think we need to flesh put how to do cross project specs, and
better cross project communication in general, as this will become more
important in the future, this email thread doesn't seem like the
Appropriate place to do it. This sounds like a new topic, that deserves a
new thread.

 Carl

 [1] https://review.openstack.org/#/c/90150/
 [2] https://review.openstack.org/#/c/88623/

 On Mon, Aug 4, 2014 at 8:33 PM, Jeremy Stanley fu...@yuggoth.org wrote:
  On 2014-08-05 01:26:49 + (+), joehuang wrote:
  I would like to know how to submit cross project spec? Is there a
  repository for cross project cross project spec.
 
  Specs repositories are about formalizing/streamlining the design
  process within a program, and generally the core reviewers of those
  programs decide when a spec is in a suitable condition for approval.
  In the case of a cross-program spec (which I assume is what you mean
  by cross-project), who would decide what needs to be in the spec
  proposal and who would approve it? What sort of design proposal do
  you have in mind which you think would need to be a single spec
  applying to projects in more than one program?
  --
  Jeremy Stanley
 
  ___
  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] [all] specs.openstack.org is live

2014-08-04 Thread Thierry Carrez
Andreas Jaeger wrote:
 All OpenStack incubated projects and programs that use a -specs
 repository have now been setup to publish these to
 http://specs.openstack.org. With the next merged in patch of a *-specs
 repository, the documentation will get published.
 
 The index page contains the published repos as of yesterday and it will
 be enhanced as more are setup (current patch:
 https://review.openstack.org/111476).
 
 For now, you can reach a repo directly via
 http://specs.openstack.org/$ORGANIZATION/$project-specs, for example:
 http://specs.openstack.org/openstack/qa-specs/
 
 Thanks to Steve Martinelli and to the infra team (especially Clark,
 James, Jeremy and Sergey) for getting this done!

Nice work!

-- 
Thierry Carrez (ttx)

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


Re: [openstack-dev] [all] specs.openstack.org is live

2014-08-04 Thread Steve Gordon
- Original Message -
 From: Andreas Jaeger a...@suse.com
 To: openstack-dev@lists.openstack.org
 
 All OpenStack incubated projects and programs that use a -specs
 repository have now been setup to publish these to
 http://specs.openstack.org. With the next merged in patch of a *-specs
 repository, the documentation will get published.

Is there a way to manually trigger this for Nova and Neutron? As these projects 
are well past their self-enforced spec approval deadlines there may not be any 
merges to their respective -specs repositories for a while now.

Thanks,

-- 
Steve Gordon, RHCE
Sr. Technical Product Manager,
Red Hat Enterprise Linux OpenStack Platform

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


Re: [openstack-dev] [all] specs.openstack.org is live

2014-08-04 Thread Andreas Jaeger
On 08/04/2014 01:52 PM, Steve Gordon wrote:
 - Original Message -
 From: Andreas Jaeger a...@suse.com
 To: openstack-dev@lists.openstack.org

 All OpenStack incubated projects and programs that use a -specs
 repository have now been setup to publish these to
 http://specs.openstack.org. With the next merged in patch of a *-specs
 repository, the documentation will get published.
 
 Is there a way to manually trigger this for Nova and Neutron? As these 
 projects are well past their self-enforced spec approval deadlines there may 
 not be any merges to their respective -specs repositories for a while now.

Just a dummy commit. I'm sure you find a typo to fix or something like
that;)

Andreas
-- 
 Andreas Jaeger aj@{suse.com,opensuse.org} Twitter: jaegerandi
  SUSE LINUX Products GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
   GF: Jeff Hawn,Jennifer Guild,Felix Imendörffer,HRB16746 (AG Nürnberg)
GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126

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


Re: [openstack-dev] [all] specs.openstack.org is live

2014-08-04 Thread Russell Bryant
On 08/04/2014 08:13 AM, Andreas Jaeger wrote:
 On 08/04/2014 01:52 PM, Steve Gordon wrote:
 - Original Message -
 From: Andreas Jaeger a...@suse.com
 To: openstack-dev@lists.openstack.org

 All OpenStack incubated projects and programs that use a -specs
 repository have now been setup to publish these to
 http://specs.openstack.org. With the next merged in patch of a *-specs
 repository, the documentation will get published.

 Is there a way to manually trigger this for Nova and Neutron? As these 
 projects are well past their self-enforced spec approval deadlines there may 
 not be any merges to their respective -specs repositories for a while now.
 
 Just a dummy commit. I'm sure you find a typo to fix or something like
 that;)

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

-- 
Russell Bryant

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


Re: [openstack-dev] [all] specs.openstack.org is live

2014-08-04 Thread Russell Bryant
On 08/04/2014 11:25 AM, Russell Bryant wrote:
 On 08/04/2014 08:13 AM, Andreas Jaeger wrote:
 On 08/04/2014 01:52 PM, Steve Gordon wrote:
 - Original Message -
 From: Andreas Jaeger a...@suse.com
 To: openstack-dev@lists.openstack.org

 All OpenStack incubated projects and programs that use a -specs
 repository have now been setup to publish these to
 http://specs.openstack.org. With the next merged in patch of a *-specs
 repository, the documentation will get published.

 Is there a way to manually trigger this for Nova and Neutron? As these 
 projects are well past their self-enforced spec approval deadlines there 
 may not be any merges to their respective -specs repositories for a while 
 now.

 Just a dummy commit. I'm sure you find a typo to fix or something like
 that;)
 
 https://review.openstack.org/#/c/111762/
 

And for Neutron: https://review.openstack.org/111765

-- 
Russell Bryant

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


Re: [openstack-dev] [all] specs.openstack.org is live

2014-08-04 Thread Kyle Mestery
On Mon, Aug 4, 2014 at 10:46 AM, Russell Bryant rbry...@redhat.com wrote:
 On 08/04/2014 11:25 AM, Russell Bryant wrote:
 On 08/04/2014 08:13 AM, Andreas Jaeger wrote:
 On 08/04/2014 01:52 PM, Steve Gordon wrote:
 - Original Message -
 From: Andreas Jaeger a...@suse.com
 To: openstack-dev@lists.openstack.org

 All OpenStack incubated projects and programs that use a -specs
 repository have now been setup to publish these to
 http://specs.openstack.org. With the next merged in patch of a *-specs
 repository, the documentation will get published.

 Is there a way to manually trigger this for Nova and Neutron? As these 
 projects are well past their self-enforced spec approval deadlines there 
 may not be any merges to their respective -specs repositories for a while 
 now.

 Just a dummy commit. I'm sure you find a typo to fix or something like
 that;)

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


 And for Neutron: https://review.openstack.org/111765

You beat me by a little bit, as I had this one:

https://review.openstack.org/111766

:)

 --
 Russell Bryant

 ___
 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] [all] specs.openstack.org is live

2014-08-04 Thread Andreas Jaeger
Great, I've updated my patch to add neutron and nova to the index page.

For now read the specs using:
http://specs.openstack.org/openstack/neutron-specs/
http://specs.openstack.org/openstack/nova-specs/

Andreas
-- 
 Andreas Jaeger aj@{suse.com,opensuse.org} Twitter/Identica: jaegerandi
  SUSE LINUX Products GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
   GF: Jeff Hawn,Jennifer Guild,Felix Imendörffer,HRB16746 (AG Nürnberg)
GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126

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


Re: [openstack-dev] [all] specs.openstack.org is live

2014-08-04 Thread John Dickinson
Can you please add Swift as well?

--John



On Aug 4, 2014, at 9:54 AM, Andreas Jaeger a...@suse.com wrote:

 Great, I've updated my patch to add neutron and nova to the index page.
 
 For now read the specs using:
 http://specs.openstack.org/openstack/neutron-specs/
 http://specs.openstack.org/openstack/nova-specs/
 
 Andreas
 -- 
 Andreas Jaeger aj@{suse.com,opensuse.org} Twitter/Identica: jaegerandi
  SUSE LINUX Products GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
   GF: Jeff Hawn,Jennifer Guild,Felix Imendörffer,HRB16746 (AG Nürnberg)
GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126
 
 ___
 OpenStack-dev mailing list
 OpenStack-dev@lists.openstack.org
 http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev



signature.asc
Description: Message signed with OpenPGP using GPGMail
___
OpenStack-dev mailing list
OpenStack-dev@lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev


Re: [openstack-dev] [all] specs.openstack.org is live

2014-08-04 Thread Steve Martinelli
Done - https://review.openstack.org/#/c/111865/
But it would be great if the swift team
could push this one too: https://review.openstack.org/#/c/111869/
(since it's the only *-specs on specs.openstack.org that doesn't look the
same)


Regards,

Steve Martinelli
Software Developer - Openstack
Keystone Core Member





Phone:
1-905-413-2851
E-mail: steve...@ca.ibm.com

8200 Warden Ave
Markham, ON L6G 1C7
Canada




From:   
John Dickinson m...@not.mn
To:   
OpenStack Development
Mailing List (not for usage questions) openstack-dev@lists.openstack.org,

Date:   
08/04/2014 05:39 PM
Subject:  
 Re: [openstack-dev]
[all] specs.openstack.org is live




Can you please add Swift as well?

--John



On Aug 4, 2014, at 9:54 AM, Andreas Jaeger a...@suse.com wrote:

 Great, I've updated my patch to add neutron and nova to the index
page.
 
 For now read the specs using:
 http://specs.openstack.org/openstack/neutron-specs/
 http://specs.openstack.org/openstack/nova-specs/
 
 Andreas
 -- 
 Andreas Jaeger aj@{suse.com,opensuse.org} Twitter/Identica: jaegerandi
 SUSE LINUX Products GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
  GF: Jeff Hawn,Jennifer Guild,Felix Imendörffer,HRB16746 (AG
Nürnberg)
  GPG fingerprint = 93A3 365E CE47 B889 DF7F FED1
389A 563C C272 A126
 
 ___
 OpenStack-dev mailing list
 OpenStack-dev@lists.openstack.org
 http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev

[attachment signature.asc deleted by Steve Martinelli/Toronto/IBM]
___
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] [all] specs.openstack.org is live

2014-08-04 Thread joehuang
Hi,

Good job!

I would like to know how to submit cross project spec? Is there a repository 
for cross project cross project spec.

Best Regards
Chaoyi Huang ( Joe Huang )


-邮件原件-
发件人: Andreas Jaeger [mailto:a...@suse.com] 
发送时间: 2014年8月3日 1:17
收件人: openstack-dev@lists.openstack.org
主题: [openstack-dev] [all] specs.openstack.org is live

All OpenStack incubated projects and programs that use a -specs repository have 
now been setup to publish these to http://specs.openstack.org. With the next 
merged in patch of a *-specs repository, the documentation will get published.

The index page contains the published repos as of yesterday and it will be 
enhanced as more are setup (current patch:
https://review.openstack.org/111476).

For now, you can reach a repo directly via 
http://specs.openstack.org/$ORGANIZATION/$project-specs, for example:
http://specs.openstack.org/openstack/qa-specs/

Thanks to Steve Martinelli and to the infra team (especially Clark, James, 
Jeremy and Sergey) for getting this done!

Andreas
--
 Andreas Jaeger aj@{suse.com,opensuse.org} Twitter/Identica: jaegerandi
  SUSE LINUX Products GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
   GF: Jeff Hawn,Jennifer Guild,Felix Imendörffer,HRB16746 (AG Nürnberg)
GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126

___
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] [all] specs.openstack.org is live

2014-08-04 Thread Jeremy Stanley
On 2014-08-05 01:26:49 + (+), joehuang wrote:
 I would like to know how to submit cross project spec? Is there a
 repository for cross project cross project spec.

Specs repositories are about formalizing/streamlining the design
process within a program, and generally the core reviewers of those
programs decide when a spec is in a suitable condition for approval.
In the case of a cross-program spec (which I assume is what you mean
by cross-project), who would decide what needs to be in the spec
proposal and who would approve it? What sort of design proposal do
you have in mind which you think would need to be a single spec
applying to projects in more than one program?
-- 
Jeremy Stanley

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