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. 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. Michael On Wed Feb 04 2015 at 9:09:22 AM Thai Q Tran <tqtran at us.ibm.com> wrote: > As we're moving toward Angular, might make sense for us to adopt ngdoc as > well. > > -----Matthew Farina <matt at mattfarina.com> wrote: ----- > To: "OpenStack Development Mailing List (not for usage questions)" < > openstack-dev at lists.openstack.org> > From: Matthew Farina <matt at mattfarina.com> > Date: 02/04/2015 05:42AM > Subject: [openstack-dev] [horizon] JavaScript docs? > > > 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? > > For anyone who doesn't know, Angular uses ngdoc (an extension to the > commonly used jsdoc) which is written up at > https://github.com/angular/angular.js/wiki/Writing-AngularJS-Documentation > . > __________________________________________________________________________ > OpenStack Development Mailing List (not for usage questions) > Unsubscribe: OpenStack-dev-request at lists.openstack.org?subject:unsubscribe > http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev > __________________________________________________________________________ > OpenStack Development Mailing List (not for usage questions) > Unsubscribe: OpenStack-dev-request at lists.openstack.org?subject:unsubscribe > http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev > -------------- next part -------------- An HTML attachment was scrubbed... URL: <http://lists.openstack.org/pipermail/openstack-dev/attachments/20150204/6e828e30/attachment.html>