<p dir="ltr">I had been under the impression that all BPs we going to require a spec. I, however, was made are in today's cinder meeting that we are only requiring specs for changes that change the user's interaction with the system or are a large change that touches the broader cinder code base. </p>
<p dir="ltr">This seemsto make sense to me. The user's commit message and unit tests should show the thought of the changes impact. </p>
<p dir="ltr">Jay</p>
<div class="gmail_quote">On Jul 9, 2014 7:57 AM, "Dugger, Donald D" <<a href="mailto:donald.d.dugger@intel.com">donald.d.dugger@intel.com</a>> wrote:<br type="attribution"><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div lang="EN-US" link="blue" vlink="purple">
<div>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1f497d">Much as I dislike the overhead and the extra latency involved (now you need to have a review cycle for the spec plus the review cycle for the patch itself)
I agreed with the `small features require small specs’. The problem is that even a small change can have a big impact. Forcing people to create a spec even for small features means that it’s very clear that the implications of the feature have been thought
about and addressed.<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1f497d"><u></u> <u></u></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1f497d">Note that there is a similar issue with bugs. I would expect that a patch to fix a bug would have to have a corresponding bug report. Just accepting patches
with no known justification seems like the wrong way to go.<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1f497d"><u></u> <u></u></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1f497d">--<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1f497d">Don Dugger<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1f497d">"Censeo Toto nos in Kansa esse decisse." - D. Gale<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1f497d">Ph: <a href="tel:303%2F443-3786" value="+13034433786" target="_blank">303/443-3786</a><u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1f497d"><u></u> <u></u></span></p>
<p class="MsoNormal"><b><span style="font-size:11.0pt;font-family:"Calibri","sans-serif"">From:</span></b><span style="font-size:11.0pt;font-family:"Calibri","sans-serif""> Dolph Mathews [mailto:<a href="mailto:dolph.mathews@gmail.com" target="_blank">dolph.mathews@gmail.com</a>]
<br>
<b>Sent:</b> Tuesday, July 1, 2014 11:02 AM<br>
<b>To:</b> OpenStack Development Mailing List (not for usage questions)<br>
<b>Subject:</b> Re: [openstack-dev] [all][specs] Please stop doing specs for any changes in projects<u></u><u></u></span></p>
<p class="MsoNormal"><u></u> <u></u></p>
<div>
<div>
<p class="MsoNormal" style="margin-bottom:12.0pt">The argument has been made in the past that small features will require correspondingly small specs. If there's a counter-argument to this example (a "small" feature requiring a relatively large amount of spec
effort), I'd love to have links to both the spec and the resulting implementation so we can discuss exactly why the spec was an unnecessary additional effort.<u></u><u></u></p>
<div>
<p class="MsoNormal">On Tue, Jul 1, 2014 at 10:30 AM, Jason Dunsmore <<a href="mailto:jason.dunsmore@rackspace.com" target="_blank">jason.dunsmore@rackspace.com</a>> wrote:<u></u><u></u></p>
<blockquote style="border:none;border-left:solid #cccccc 1.0pt;padding:0in 0in 0in 6.0pt;margin-left:4.8pt;margin-right:0in">
<p class="MsoNormal">On Mon, Jun 30 2014, Joshua Harlow wrote:<br>
<br>
> There is a balance here that needs to be worked out and I've seen<br>
> specs start to turn into requirements for every single patch (even if<br>
> the patch is pretty small). I hope we can rework the 'balance in the<br>
> force' to avoid being so strict that every little thing requires a<br>
> spec. This will not end well for us as a community.<br>
><br>
> How have others thought the spec process has worked out so far? To<br>
> much overhead, to little…?<br>
><br>
> I personally am of the opinion that specs should be used for large<br>
> topics (defining large is of course arbitrary); and I hope we find the<br>
> right balance to avoid scaring everyone away from working with<br>
> openstack. Maybe all of this is part of openstack maturing, I'm not<br>
> sure, but it'd be great if we could have some guidelines around when<br>
> is a spec needed and when isn't it and take it into consideration when<br>
> requesting a spec that the person you have requested may get<br>
> frustrated and just leave the community (and we must not have this<br>
> happen) if you ask for it without explaining why and how clearly.<br>
<br>
+1 I think specs are too much overhead for small features. A set of<br>
guidelines about when specs are needed would be sufficient. Leave the<br>
option about when to submit a design vs. when to submit code to the<br>
contributor.<br>
<span style="color:#888888"><br>
<span>Jason</span></span><u></u><u></u></p>
<div>
<div>
<p class="MsoNormal"><br>
_______________________________________________<br>
OpenStack-dev mailing list<br>
<a href="mailto:OpenStack-dev@lists.openstack.org" target="_blank">OpenStack-dev@lists.openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a><u></u><u></u></p>
</div>
</div>
</blockquote>
</div>
<p class="MsoNormal"><u></u> <u></u></p>
</div>
</div>
</div>
</div>
<br>_______________________________________________<br>
OpenStack-dev mailing list<br>
<a href="mailto:OpenStack-dev@lists.openstack.org">OpenStack-dev@lists.openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a><br>
<br></blockquote></div>