<div dir="ltr"><div class="gmail_extra"><br><div class="gmail_quote">On Wed, Sep 3, 2014 at 8:25 AM, Sean Dague <span dir="ltr"><<a href="mailto:sean@dague.net" target="_blank">sean@dague.net</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">

<div class="">On 09/03/2014 09:03 AM, Daniel P. Berrange wrote:<br>
> On Wed, Sep 03, 2014 at 08:37:17AM -0400, Sean Dague wrote:<br>
>> I'm not sure why people keep showing up with "sort requirements" patches<br>
>> like - <a href="https://review.openstack.org/#/c/76817/6" target="_blank">https://review.openstack.org/#/c/76817/6</a>, however, they do.<br>
>><br>
>> All of these need to be -2ed with predjudice.<br>
>><br>
>> requirements.txt is not a declarative interface. The order is important<br>
>> as pip processes it in the order it is. Changing the order has impacts<br>
>> on the overall integration which can cause wedges later.<br>
><br>
> Can  requirements.txt contain comment lines ?  If so, it would be<br>
> worth adding<br>
><br>
>    # The ordering of modules in this file is important<br>
>    # Do not attempt to re-sort the lines<br>
><br>
> Because 6 months hence people will have probably forgotten about<br>
> this mail, or if they're new contributors, never know it existed.<br>
<br>
</div>The point is that core review team members should know. In this case at<br>
least one glance core +2ed this change.<br>
<br>
Regular contributors can be educated by core team members.<br></blockquote><div><br></div><div>Regardless, tribal knowledge should be documented, and doing so in requirements files is probably the best place for that.</div>

<div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div class="im HOEnZb"><br>
        -Sean<br>
<br>
--<br>
Sean Dague<br>
<a href="http://dague.net" target="_blank">http://dague.net</a><br>
<br>
</div><div class="HOEnZb"><div class="h5">_______________________________________________<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>
</div></div></blockquote></div><br></div></div>