<div dir="ltr">At least with the installation guide, I think people generally assume that /trunk contains corrections and other improvements for the stable documentation rather than functionality for the next release. When I first tried installing OpenStack, most people pointed me at /trunk and I wound up using a combination of the latter and stable branch to build my first functional environment. We probably haven't seen many bug reports on /trunk until now because most of the basic configuration for core components except networking remained the same (or similar enough to work) through Grizzly, Havana, and Icehouse. We definitely need to provide better indication of the target audience for /trunk, but I also think several solid releases of the installation guide will cause more people to focus on the stable branch.</div>
<div class="gmail_extra"><br><br><div class="gmail_quote">On Fri, Jun 20, 2014 at 6:37 AM, Anne Gentle <span dir="ltr"><<a href="mailto:anne@openstack.org" target="_blank">anne@openstack.org</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 patch is fine, let's see if that causes any rage. <div><br></div><div>How about this: for the install guide we just don't publish to /trunk. <div><br></div><div>I also like the django header but when I suggested using our existing DRAFT watermark in the 1191447 but someone (can't recall who) said it wouldn't be enough. </div>


<div><br></div><div>The /trunk content was meant to be much less findable but over the years it has become sought. It's probably time to delete it entirely now that we have docs-draft links always available.</div></div>


<div>What do you think?</div><span class="HOEnZb"><font color="#888888"><div>Anne</div></font></span></div><div class="HOEnZb"><div class="h5"><div class="gmail_extra"><br><br><div class="gmail_quote">On Fri, Jun 20, 2014 at 2:44 AM, Gauvain Pocentek <span dir="ltr"><<a href="mailto:gauvain.pocentek@objectif-libre.com" target="_blank">gauvain.pocentek@objectif-libre.com</a>></span> wrote:<br>


<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Le 2014-06-20 09:18, Tom Fifield a écrit :<div><br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
On 20/06/14 15:13, Gauvain Pocentek wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
We've received several bug reports about the auth_strategy nova option<br>
missing from our install procedure these last few days. These bugs are<br>
reported against the trunk doc, by people installing icehouse. The doc<br>
is in fact correct, both in trunk (the default for this option in juno<br>
has changed and we don't need to set it anymore), and in the icehouse<br>
branch (where the option is set up in the procedure).<br>
<br>
Would it be possible to mark the pages in the trunk/ subdirectory of<br>
<a href="http://docs.o.org" target="_blank">docs.o.org</a> as "in progress" or "unstable", or anything that would<br>
explicitly tell the user that he might not be reading the correct page?<br>
We already have "juno" in the install-guide and config-ref titles, but I<br>
don't think it's visible enough.<br>
</blockquote>
<br>
<br>
This is indeed a problem.<br>
<br>
I find it's quite similar to our Critical bug "Clearly mark outdated<br>
doc pages" <a href="https://bugs.launchpad.net/openstack-manuals/+bug/1191447" target="_blank">https://bugs.launchpad.net/<u></u>openstack-manuals/+bug/1191447</a><br>
<br>
<br>
I've proposed a patch @ <a href="https://review.openstack.org/#/c/101428/" target="_blank">https://review.openstack.org/#<u></u>/c/101428/</a> that<br>
will make it more obvious that trunk is juno, but I don't think it<br>
solves the problem.<br>
</blockquote>
<br></div>
Users following the guide will very soon realize that this is not what they want with this patch. IMO that's a good thing. With the current trunk/, I'm quite sure that people end up thinking "the doc is not good, I can't get this thing to work". We really don't want them to think that :)<br>



<br>
When starting this thread I had the django documentation website in head. They have a relatively visible warning on the top of dev version pages: <a href="https://docs.djangoproject.com/en/dev/" target="_blank">https://docs.djangoproject.<u></u>com/en/dev/</a> . If Tom's patch is not enough, we could look into implementing a similar feature.<span><font color="#888888"><br>



<br>
Gauvain</font></span><div><div><br>
<br>
______________________________<u></u>_________________<br>
Openstack-docs mailing list<br>
<a href="mailto:Openstack-docs@lists.openstack.org" target="_blank">Openstack-docs@lists.<u></u>openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" target="_blank">http://lists.openstack.org/<u></u>cgi-bin/mailman/listinfo/<u></u>openstack-docs</a><br>
</div></div></blockquote></div><br></div>
</div></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></div>