<div dir="ltr">Jekyll as an option for pre-rendering the html?<div><br></div><div><a href="http://jekyllrb.com">http://jekyllrb.com</a><br></div><div><br></div><div>Brgds,</div><div>  Marton Kiss</div></div><br><div class="gmail_quote"><div dir="ltr">On Thu, Sep 3, 2015 at 8:31 PM Jeremy Stanley <<a href="mailto:fungi@yuggoth.org">fungi@yuggoth.org</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">On 2015-08-27 16:13:29 -0500 (-0500), Anne Gentle wrote:<br>
[...]<br>
> In order to serve API reference docs, we need a Pecan server on a cloud<br>
> server of some sort. I'm guessing this server could be deployed with Puppet<br>
> but I really don't know.<br>
><br>
> The specification for revising API docs [1] gives some detail about the<br>
> fairy-slipper tool [2] being developed that gets us out of WADL and into<br>
> JSON. The JSON needs a Python web framework to host the reference content.<br>
> An example of the output is at [3].<br>
[...]<br>
<br>
Trying to summarize some of the subsequent discussion[1] which took<br>
place last week in #openstack-infra: while not ruling out the<br>
benefits of a separate server (particularly for interesting future<br>
additions like an interactive API sandbox), there are still good<br>
reasons to prefer processes which independently build static content<br>
for upload instead of regenerating the same content on demand on the<br>
server where it's hosted (since it can also be easily packaged and<br>
redistributed if it has a known state).<br>
<br>
An option worth looking into is whether fairy-slipper could be<br>
pointed at running services in a devstack-gate job to generate that<br>
JSON, and also perhaps whether the resulting JSON could be<br>
pre-rendered into its final state prior to upload to the Web site or<br>
if necessary integrated into a page template client-side with some<br>
Javascript.<br>
<br>
[1] <URL: <a href="http://eavesdrop.openstack.org/irclogs/%23openstack-infra/%23openstack-infra.2015-08-28.log.html#t2015-08-28T20:20:45" rel="noreferrer" target="_blank">http://eavesdrop.openstack.org/irclogs/%23openstack-infra/%23openstack-infra.2015-08-28.log.html#t2015-08-28T20:20:45</a> ><br>
--<br>
Jeremy Stanley<br>
<br>
_______________________________________________<br>
OpenStack-Infra mailing list<br>
<a href="mailto:OpenStack-Infra@lists.openstack.org" target="_blank">OpenStack-Infra@lists.openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-infra" rel="noreferrer" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-infra</a><br>
</blockquote></div>