<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Fri, May 8, 2015 at 8:06 AM, Anne Gentle <span dir="ltr"><<a href="mailto:annegentle@justwriteclick.com" target="_blank">annegentle@justwriteclick.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"><br><div class="gmail_extra"><br><div class="gmail_quote"><span class="">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>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></span><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></div></div></blockquote><div><br></div><div>Oh and not to argue with myself, ha ha, but also, no consumer of these docs is using a cloud that adds API calls at the same time as they land in master branch. Even here at Rackspace with our continuous deployment, we carefully add new calls for end-users later than they actually land in the master branch.</div><div><br></div><div>Still, the vision is a useful guide for those consumers, and that's what I'll keep as job one.</div><div><br></div><div>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"><div class="gmail_extra"><div class="gmail_quote"><div>Anne</div><span class=""><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<span><font color="#888888">--<br>
Jeremy Stanley<br>
</font></span><div><div><br>
_______________________________________________<br>
OpenStack-docs mailing list<br>
<a href="mailto:OpenStack-docs@lists.openstack.org" target="_blank">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></span></div><span class="HOEnZb"><font color="#888888"><br><br clear="all"><div><br></div>-- <br><div>Anne Gentle<br><a href="mailto:annegentle@justwriteclick.com" target="_blank">annegentle@justwriteclick.com</a></div>
</font></span></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>