<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Fri, May 8, 2015 at 7:55 AM, Jeremy Stanley <span dir="ltr"><<a href="mailto:fungi@yuggoth.org" target="_blank">fungi@yuggoth.org</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span class="">On 2015-05-08 07:48:57 -0500 (-0500), Anne Gentle wrote:<br>
> So I woke up this morning and realized, there's no way we should<br>
> be using stable/release branches to generate docs. The reviewers<br>
> are fewer for those branches and less likely to know anything<br>
> about API changes and uses.<br>
</span>[...]<br>
<br>
More to the point, APIs aren't supposed to change in stable<br>
branches. That's one of the things that makes them "stable."<br></blockquote><div><br></div><div>Right, but the counterpoint is that docs are supposed to document final state and truth, and by scraping during a non-final dev time period, the docs won't themselves be stable. So that's where the difficulty lies. :)</div><div>Anne</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<span class="HOEnZb"><font color="#888888">--<br>
Jeremy Stanley<br>
</font></span><div class="HOEnZb"><div class="h5"><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>
</div></div></blockquote></div><br><br clear="all"><div><br></div>-- <br><div class="gmail_signature">Anne Gentle<br><a href="mailto:annegentle@justwriteclick.com" target="_blank">annegentle@justwriteclick.com</a></div>
</div></div>