<div dir="ltr"><br><div class="gmail_extra"><br><br><div class="gmail_quote">On Mon, Aug 5, 2013 at 10:36 AM, Christopher Yeoh <span dir="ltr"><<a href="mailto:cbkyeoh@gmail.com" target="_blank">cbkyeoh@gmail.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div class="im">On Mon, 5 Aug 2013 14:55:15 +0100<br>
John Garbutt <<a href="mailto:john@johngarbutt.com">john@johngarbutt.com</a>> wrote:<br>
> Given we seem to be leaning towards WSME:<br>
> <a href="http://lists.openstack.org/pipermail/openstack-dev/2013-August/012954.html" target="_blank">http://lists.openstack.org/pipermail/openstack-dev/2013-August/012954.html</a><br>
><br>
> Could we not try to make WSME give us the documentation we need?<br>
><br>
> Not sure if its feasible, but it seems like there is a good start to<br>
> that already available:<br>
> <a href="https://wsme.readthedocs.org/en/latest/document.html" target="_blank">https://wsme.readthedocs.org/en/latest/document.html</a><br>
<br>
</div>Hrm its not clear from there how the API samples are generated.<br></blockquote><div><br></div><div>Each type declared for the API has a class method to instantiate a sample object. That object is then passed through the appropriate serializer (XML or JSON). reST directives embedded in our Sphinx docs trigger the conversion and render to HTML now, but we'll need to build something similar to generate standalone files for use with the DocBook-based documentation.</div>
<div><br></div><div>Doug</div><div><br></div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
But more generally I have a concern with making having a specification<br>
for the V3 API dependent on getting WSME merged - since I think its a<br>
reasonably big chunk of work and certainly won't land until sometime in<br>
the icehouse timeframe. In the meantime without some automation of the<br>
process its likely we won't have a V3 API spec as there are around 60<br>
extensions (with all their methods) to document.<br>
<div class="HOEnZb"><div class="h5"><br>
Regards,<br>
<br>
Chris<br>
<br>
_______________________________________________<br>
OpenStack-dev mailing list<br>
<a href="mailto:OpenStack-dev@lists.openstack.org">OpenStack-dev@lists.openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a><br>
</div></div></blockquote></div><br></div></div>