<div dir="ltr"><div class="gmail_extra"><div class="gmail_quote">On Tue, Oct 21, 2014 at 9:58 AM, Collins, Sean <span dir="ltr"><<a href="mailto:Sean_Collins2@cable.comcast.com" target="_blank">Sean_Collins2@cable.comcast.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">Looking at the current docs, they are all currently in raw HTML, and I<br>
was hoping that it would be possible to add Pelican[1], which would make<br>
it easier to contribute documentation since we wouldn't have to write<br>
raw HTML. This may help make contributing docs more seamless.<br></blockquote><div><br></div><div>Sean, I assume you realize that by standing up and saying this you become the first volunteer to do the work, right? ;)</div><div><br></div><div><div>Seriously, I wouldn't be against something like this and in fact would rather like to refresh the HTML docs.  Now that <a href="http://devstack.org">devstack.org</a> is generated on each commit again (thanks anteaya!) we have the ability to do so.</div></div><div><br></div><div>Questions that come to mind for further discussion:</div><div><br></div><div>* Is there a 'good enough' reason to do something new that is different from the rest of <a href="http://docs.openstack.org">docs.openstack.org</a>?  Bringing in the legacy site is one thing, we should have a good reason for adding yet another new build dependency.</div><div><br></div><div>* I'm interested in the opinions of the readership if the shocco-generated script pages are useful.  One of the reasons DevStack is in shell script is to make it readable by everyone and the literate-style formatting is to help with that.</div><div><br></div><div>dt</div></div><div><br></div>-- <br><br>Dean Troyer<br><a href="mailto:dtroyer@gmail.com">dtroyer@gmail.com</a><br>
</div></div>