I agree. StoryBoard's storyboard-webclient project has a lot of existing code already that's pretty well documented, but without knowing what documentation system we were going to settle on we never put any rule enforcement in place. If someone wants to take a stab at putting together a javascript docs build, that project would provide a good test bed that will let you test out the tools without having to also make them dance with python/sphinx at the same time.<br><div><br></div><div>I.E. I have a bunch of javascript that you can hack on, and the domain knowledge of the Infra JS Build tools. I'd be happy to support this effort.</div><div><br></div><div>Michael</div><br><div class="gmail_quote">On Wed Feb 04 2015 at 9:09:22 AM Thai Q Tran <<a href="mailto:tqtran@us.ibm.com">tqtran@us.ibm.com</a>> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><font face="Default Sans Serif,Verdana,Arial,Helvetica,sans-serif">As we're moving toward Angular, might make sense for us to adopt ngdoc as well.<br><br><font color="#990099">-----Matthew Farina <<a href="mailto:matt@mattfarina.com" target="_blank">matt@mattfarina.com</a>> wrote: -----</font><div style="padding-left:5px"><div style="padding-right:0px;padding-left:5px;border-left:solid black 2px">To: "OpenStack Development Mailing List (not for usage questions)" <<a href="mailto:openstack-dev@lists.openstack.org" target="_blank">openstack-dev@lists.openstack.org</a>><br>From: Matthew Farina <<a href="mailto:matt@mattfarina.com" target="_blank">matt@mattfarina.com</a>><br>Date: 02/04/2015 05:42AM<br>Subject: [openstack-dev] [horizon] JavaScript docs?</div></div></font><font face="Default Sans Serif,Verdana,Arial,Helvetica,sans-serif"><div style="padding-left:5px"><div style="padding-right:0px;padding-left:5px;border-left:solid black 2px"><br><br><div dir="ltr">In python we have a style to document methods, classes, and so forth. But, I don't see any guidance on how JavaScript should be documented. I was looking for something like jsdoc or ngdoc (an extension of jsdoc). Is there any guidance on how JavaScript should be documented?<br><br>For anyone who doesn't know, Angular uses ngdoc (an extension to the commonly used jsdoc) which is written up at <a href="https://github.com/angular/angular.js/wiki/Writing-AngularJS-Documentation" target="_blank">https://github.com/angular/angular.js/wiki/Writing-AngularJS-Documentation</a>.<br></div>
<div><font face="Courier New,Courier,monospace">__________________________________________________________________________<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></div></div></div></font>


______________________________<u></u>______________________________<u></u>______________<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.<u></u>openstack.org?subject:<u></u>unsubscribe</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" target="_blank">http://lists.openstack.org/<u></u>cgi-bin/mailman/listinfo/<u></u>openstack-dev</a><br>
</blockquote></div>