<div dir="ltr"><div><div>Replying to myself here…<br><br></div>I added a simple cache system for release docs. There is now a build_cache directory which contains build_cache/html/docs/references with the release docs (not the current doc). This directory gets synced before all builds, and builds are only made for releases that do not have a doc yet. This way, the doc will only be built when a new release tag is added.<br>
<br><br></div><div>Cheers,<br></div><div><br></div>Raphaël<br><br></div><div class="gmail_extra"><br><br><div class="gmail_quote">On Fri, Jun 21, 2013 at 12:18 AM, Raphaël Pinson <span dir="ltr"><<a href="mailto:raphael.pinson@camptocamp.com" target="_blank">raphael.pinson@camptocamp.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"><div><div><div><div><div>Hello,<br><br><br></div>I have heard several times people asking for online documentation for a specific version of Augeas. While the augeas-doc Debian package has been providing this for offline use for quite some time, I thought it would indeed be a good idea to have an online version, in a similar way to what is done for Puppet for example.<br>

<br></div>So I went ahead and adapted the scripts to build the website, so the doc is generated for all tagged releases in git.<br><br></div>This is already pushed to <a href="http://augeas.net" target="_blank">augeas.net</a>. As a result:<br>

<br></div>* You can access the list of stock lenses for any release at <a href="http://augeas.net/stock_lenses/$version" target="_blank">http://augeas.net/stock_lenses/$version</a>, e.g. <a href="http://augeas.net/stock_lenses/0.5.3" target="_blank">http://augeas.net/stock_lenses/0.5.3</a><br>

</div>* Since NaturalDocs was added in 0.3.2, I have generated the online doc based on it since that release, and the stock lenses pages link to their respective versionned doc, e.g. <a href="http://augeas.net/docs/references/0.5.3/lenses" target="_blank">augeas.net/docs/references/0.5.3/lenses</a><br>

<div><div><div><div><div><div><br><br></div><div>This works quite fine, but there is one downside to this: it takes a long time to generate the website, because it builds the NaturalDocs docs for every past release. It's quite ok for now because we don't build the website every day, but I'll be thinking of a way to keep some kind of cache for previous releases, as their is no point in rebuilding docs for them every time.<br>

<br><br></div><div>Cheers,<span class="HOEnZb"><font color="#888888"><br></font></span></div><span class="HOEnZb"><font color="#888888"><div><br clear="all"><div><br>-- <br><div dir="ltr">Raphaël Pinson<br><div>Développeur et Formateur Infrastructure</div>
<div><a href="tel:%2B33%20479%2026%2057%2093" value="+33479265793" target="_blank">+33 479 26 57 93</a></div><div><br></div><div>Camptocamp France<br>

Savoie Technolac<br>
BP 352<br>
48, avenue du Lac du Bourget<br>
73372 Le Bourget du Lac, Cedex<br>
<a href="http://www.camptocamp.com" target="_blank">www.camptocamp.com</a><br>
</div></div>
</div></div></font></span></div></div></div></div></div></div>
</blockquote></div><br><br clear="all"><br>-- <br><div dir="ltr">Raphaël Pinson<br><div>Développeur et Formateur Infrastructure</div><div>+33 479 26 57 93</div><div><br></div><div>Camptocamp France<br>
Savoie Technolac<br>
BP 352<br>
48, avenue du Lac du Bourget<br>
73372 Le Bourget du Lac, Cedex<br>
<a href="http://www.camptocamp.com" target="_blank">www.camptocamp.com</a><br>
</div></div>
</div>