<div dir="ltr"><div>Ah, I had forgotten about the python module documentation. Sorry about that and thanks for pointing it out.<br><br></div>Can we have that system parse and use JSDoc? I'd like it to be useful to both JS devs and the doc generation toolchain.<br></div><div class="gmail_extra"><br><div class="gmail_quote">On Thu, Feb 5, 2015 at 9:42 AM, Jeremy Stanley <span dir="ltr"><<a href="mailto:fungi@yuggoth.org" target="_blank">fungi@yuggoth.org</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">On 2015-02-05 09:20:35 -0800 (-0800), Matthew Farina wrote:<br>
[...]<br>
> But, why do we document methods, classes, or functions in python?<br>
> Should we drop that and rely on Sphinx? I don't think anyone would<br>
> argue for that.<br>
[...]<br>
<br>
Particularly since Sphinx collects the method/class/function<br>
docstrings from the source code to assemble them into<br>
documentation[1]. I see that as its primary reason for existing in<br>
fact. Why do you seem to think those choices are at odds with one<br>
another?<br>
<br>
[1] <a href="http://docs.openstack.org/developer/nova/api/nova.api.validator.html" target="_blank">http://docs.openstack.org/developer/nova/api/nova.api.validator.html</a><br>
<span class="HOEnZb"><font color="#888888">--<br>
Jeremy Stanley<br>
<br>
__________________________________________________________________________<br>
OpenStack Development Mailing List (not for usage questions)<br>
Unsubscribe: <a href="http://OpenStack-dev-request@lists.openstack.org?subject:unsubscribe" target="_blank">OpenStack-dev-request@lists.openstack.org?subject:unsubscribe</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>
</font></span></blockquote></div><br></div>