<div dir="ltr"><br><div class="gmail_extra"><br><br><div class="gmail_quote">On Tue, Jun 11, 2013 at 2:51 PM, Lorin Hochstein <span dir="ltr"><<a href="mailto:lorin@nimbisservices.com" target="_blank">lorin@nimbisservices.com</a>></span> wrote:<br>

<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr">Tom's DocImpact automation proposal <<a href="https://review.openstack.org/25887" target="_blank">https://review.openstack.org/25887</a>> got me thinking more generally about DocImpact and new features.<div>

<br></div>
<div>I would like to propose to the opentack-dev mailing list that for commits that require doc changes ("DocImpact"), there must be sufficient information in the commit message for a member of the doc team to use this info to update the docs (i.e., we shouldn't need to go splunking through the code diff).</div>


<div><br></div><div>If there isn't enough info in the commit log, then it should be socially acceptable to vote "-1" on the proposed code change.</div><div><br></div><div>Does that sound reasonable?</div><span class="HOEnZb"><font color="#888888"><div>


<br></div></font></span></div></blockquote><div><br></div><div><br></div><div style>Absolutely, and at the TC dinner in Portland, Michael Still was saying something very similar, that he'll down vote DocImpact patches that don't have all the configuration information spelled out in the commit message. I don't know how that's going in reality, though. But you are certainly in the right to do so, and it seems very legit from a documentor's perspective that you want more info. CCing Michael in case he has more input on how it's going, asking for info in commit messages.</div>

<div style><br></div><div style>Anne</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><span class="HOEnZb"><font color="#888888"><div></div>

<div>Lorin<br><div><div><br></div>-- <br><div dir="ltr">Lorin Hochstein<br><div>Lead Architect - Cloud Services</div><div>Nimbis Services, Inc.</div><div><a href="http://www.nimbisservices.com" target="_blank">www.nimbisservices.com</a></div>


</div>
</div></div></font></span></div>
<br>_______________________________________________<br>
Openstack-docs mailing list<br>
<a href="mailto:Openstack-docs@lists.openstack.org">Openstack-docs@lists.openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
<br></blockquote></div><br><br clear="all"><div><br></div>-- <br>Anne Gentle<br><a href="mailto:annegentle@justwriteclick.com" target="_blank">annegentle@justwriteclick.com</a>
</div></div>