<div dir="ltr"><div>Andreas,<br><br>I like your 4th option as it is the easiest way to go. But only if the versions will be available from the docs home page as it is at the moment - More Releases and Languages menu.<br><br></div>Thanks,<br>Olga<br></div><div class="gmail_extra"><br><div class="gmail_quote">On Wed, Mar 16, 2016 at 6:44 AM, Lana Brindley <span dir="ltr"><<a href="mailto:openstack@lanabrindley.com" target="_blank">openstack@lanabrindley.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">-----BEGIN PGP SIGNED MESSAGE-----<br>
Hash: SHA256<br>
<div><div class="h5"><br>
On 16/03/16 05:47, Andreas Jaeger wrote:<br>
> Currently our guides using openstackdocstheme (and that includes also<br>
> documents like Compute API in the nova repository) hardcode the release<br>
> name and links to releases in them.<br>
><br>
> See the attached screenshot for an example or look directly at one of<br>
> the guides like <a href="http://docs.openstack.org/admin-guide-cloud/" rel="noreferrer" target="_blank">http://docs.openstack.org/admin-guide-cloud/</a> .<br>
><br>
> This already confused some folks since we always build with latest theme<br>
> and thus the kilo guide now will have Liberty in the theme. Also, we<br>
> have guides that are version independent - we call them also continously<br>
> released - like User Guides. These cover the current "supported"<br>
> releases but they have only "Liberty" written on them.<br>
><br>
> With each OpenStack release we face the challenge to update the<br>
> openstackdocstheme at the right time. We don't want to do it too early -<br>
> so not have yet Mitaka out - but also not to late - we'd love to be<br>
> ready when Mitaka is out. This puts stress on OpenStack and<br>
> documentation release teams to release this timely - against the normal<br>
> policies setup for releases.<br>
><br>
> I chatted earlier today with Doug Hellmann and Dims and we discussed<br>
> some options including the following:<br>
><br>
> 1) Leave status quo.<br>
> 2) Enhance openstackdocstheme to have an option that names the release.<br>
> This means we need to add to each of the 10+ repos currently using it<br>
> this option. Advantages are that we could even have different links<br>
> there - for Liberty guides, links to Liberty, for Mitaka ones, links to<br>
> Mitaka,...<br>
> 3) Add the next release links far earlier (now). This will remove<br>
> pressure everywhere but forces us to publish a <a href="http://docs.openstack.org/mitaka" rel="noreferrer" target="_blank">docs.openstack.org/mitaka</a><br>
> page as well.<br>
> 4) Remove the version completely, instead point to <a href="http://docs.openstack.org" rel="noreferrer" target="_blank">docs.openstack.org</a><br>
> top level page. In that case, we should also remove the list of releases<br>
> from the navigation bar.<br>
> 5) Any other options we didn't think about?<br>
><br>
> I'm in favor of option 4 since that avoids confusion and avoids last<br>
> minute changes.<br>
<br>
</div></div>+1 to option 4. It's the least maintenance-heavy, and also less confusing for readers.<br>
<br>
L<br>
<br>
- --<br>
Lana Brindley<br>
Technical Writer<br>
Rackspace Cloud Builders Australia<br>
<a href="http://lanabrindley.com" rel="noreferrer" target="_blank">http://lanabrindley.com</a><br>
-----BEGIN PGP SIGNATURE-----<br>
Version: GnuPG v2<br>
Comment: Using GnuPG with Thunderbird - <a href="http://www.enigmail.net/" rel="noreferrer" target="_blank">http://www.enigmail.net/</a><br>
<br>
iQEcBAEBCAAGBQJW6OSwAAoJELppzVb4+KUyx3AH/iSJGlMh4FbQKv41PLvbIqCY<br>
/Gp9q3Rev6bRNf4WVvS8CQ+vzB9K9ldUkAPKfqwrW6ASFszugdTwj91u6dbR5XxC<br>
25NOGCsNkAs7ejbORWl0XER+bDez4j5iMkqPc6kwzkaWIkcDB12l6evuVpTwXfoq<br>
IbchKEoqMB2vIsQH3aJLjHzNOkPldFDavzISmgzrOAkXdYCaWiCjBm79XYVE1T9t<br>
MjxKwGVOn0ByuuCRepXTJrehJfixSaSBmkZQp7JIiXPQ+2+jCuYIiE+gBq7lVaE4<br>
ouOttsv+qbjYV+dX+WZqHade83p5P9LHP+cQ6rJdzBOVkSb9qgfMYdHG0h7SkbU=<br>
=OwHp<br>
-----END PGP SIGNATURE-----<br>
<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" rel="noreferrer" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
</blockquote></div><br><br clear="all"><br>-- <br><div class="gmail_signature"><div dir="ltr"><div><div dir="ltr"><div><div dir="ltr"><div><div dir="ltr"><div><div dir="ltr"><div><div dir="ltr"><div><div dir="ltr"><div><div dir="ltr"><div><div><span style="color:rgb(102,102,102)">Best regards,<br></span></div><span style="color:rgb(102,102,102)">Olga Gusarenko<br><br></span></div><span style="color:rgb(102,102,102)">Technical Writer<span><span> | Mirantis, Kharkiv | 38, Lenin av., Kharkiv, Ukraine<br></span></span></span><div><span style="color:rgb(102,102,102)"><a href="mailto:ogusarenko@mirantis.com" target="_blank">ogusarenko@mirantis.com</a> <span><span>| </span></span>skype: gusarenko.olga <span><span>| +38 (050) 843-14-25</span></span><span><span></span></span></span></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div>
</div>