[openstack-dev] [all][specs] Please stop doing specs for any changes in projects

Doug Hellmann doug at doughellmann.com
Mon Jul 21 15:02:30 UTC 2014



On Sun, Jul 20, 2014, at 04:35 PM, Jay S. Bryant wrote:
> Thanks Duncan and also Dolph, I should have made the question
> broader.  :-)
> 
> On Wed, 2014-07-16 at 13:22 +0100, Duncan Thomas wrote:
> > On 16 July 2014 03:57, Jay S. Bryant <jsbryant at electronicjungle.net> wrote:
> > > John,
> > >
> > > So you have said a few times that the specs are a learning process.
> > > What do you feel with have learned thus far using specs?
> > 
> > I'm not John, but I'm going to answer as if you'd addressed the question wider:
> > - Specs can definitely help flesh out ideas and are much better than
> > blueprints as a way of tracking concerns, questions, etc
> > 
> 
> I feel I have better knowledge of what is being worked thanks to the
> specs.  This may partially be because I was also involved from the
> summit on for the first time.  They definitely are better for fleshing
> out ideas and discussing concerns.
> 
> > - We as a community are rather shy about making decisions as
> > individuals, even low risk ones like 'Does this seem to require a
> > spec' - if there doesn't seem to be value in a spec, don't do one
> > unless somebody asks for one
> 
> Agreed.  I think we all need to be less shy about making decisions and
> voicing them.  At least in Cinder.  :-)
> 
> > 
> > - Not all questions can be answered at spec time, sometimes you need
> > to go bash out some code to see what works, then circle again
> > 
> > - Careful planning reduces velocity. No significant evidence either
> > way as to whether it improves quality, but my gut feeling is that it
> > does. We need to figure out what tradeoffs on either scale we're happy
> > to make, and perhaps that answer is different based on the area of
> > code being touched and the date (e.g. a change that doesn't affect
> > external APIs in J-1 might need less careful planning than a change in
> > J-3. API changes or additions need more discussion and eyes on than
> > none-API changes)
> 
> I think, through this development cycle we are starting to narrow down
> what really needs a spec.  I think it would be good to perhaps have a
> Lessons Learned session at the K summit on the specs and try to better
> define expectations for use in the future.  I feel it has slowed, or at
> least focused development.  That has been good.

We should make that a cross-project session, so we can learn from what
the other projects did, too.

Doug

> 
> > 
> > - Specs are terrible for tracking work items, but no worse than blueprints
> > 
> Agreed.
> > - Multiple people might choose to work on the same blueprint in
> > parallel - this is going to happen, isn't necessarily rude and the
> > correct solution to competing patches is entirely subjective
> 
> 
> 
> _______________________________________________
> OpenStack-dev mailing list
> OpenStack-dev at lists.openstack.org
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev



More information about the OpenStack-dev mailing list