Open Stack

On Thu, Jul 31, 2014 at 2:04 PM, Andreas Jaeger <aj at suse.com> wrote:

> On 07/30/2014 09:43 PM, Gauvain Pocentek wrote:
> > Hi all,
> >
> > We have to define a workflow to define and approve specs. Anne proposed
> > the following on the HOT spec:
> >
> > - approve the blueprint in Launchpad
> > - then ask only some for docs-specs
> > - then docs-specs is just used to ensure the approach and scope are what
> > we want
> >
> > Anne please correct me if I'm twisting your words :)
> >
> > My opinion is that we should create the Launchpad BP only after a patch
> > to docs-specs has been accepted. This would make sure that there's been
> > some thinking about how things can be done, and that we agree on the
> > choices.
>
> Do we have a reference what other projects are doing? I'd like to use
> the same workflow as much as possible.
>
>
Ah, yes, I looked this up yesterday.

Nova has a blueprint in Launchpad first, then marks it "Pending Approval"
for Design.

Then once the nova-specs patch is accepted, the Design is marked "Approved."

I think this makes sense to adopt for docs. Just a few caveats: nova has a
release manager and docs does not. So the responsibility falls on the PTL
to clickety-click in Launchpad so people know what will be delivered in a
given release.

I do think that we need to keep the component of very limited reasons to
have a blueprint and upfront design at all. For nearly everything, we need
writing more than designing the writing.

Anne


> I have no strong reference either way.
>
> > My experience with the HOT spec shows that there's a lot of questions
> > that need to be answered, and LP doesn't provide a simple way to
> > discuss, modify, or keep the history of the spec definition --- which I
> > think is important. And we're used to git and gerrit anyway :)
> >
> > The HOT spec review for reference:
> https://review.openstack.org/#/c/108133/
> >
> > What so you think?
>
> 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-docs mailing list
> Openstack-docs at lists.openstack.org
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20140731/219cd81e/attachment-0001.html>