<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><div>Anne</div></div><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 class=""><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 class="HOEnZb"><font color="#888888"><br>


<br>
Gauvain</font></span><div class="HOEnZb"><div class="h5"><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>