<div class="gmail_quote">On Thu Feb 05 2015 at 12:07:01 AM Radomir Dopieralski <<a href="mailto:openstack@sheep.art.pl" target="_blank">openstack@sheep.art.pl</a>> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><br>
Plus, the documentation generator that we are using already, Sphinx,<br>
supports JavaScript perfectly fine, so I see no reason to add another tool.<br></blockquote><div><br></div><div>Try to empathize with us a little here. What you're asking is equivalent to saying "OpenStack should use JavaDoc for all its documentation because it supports python". For all the reasons that you would mistrust JavaDoc, I mistrust Sphinx when it comes to parsing javascript.</div><div><br></div><div>With that in mind, how about we run a side-by-side comparison of Sphinx vs. NGDoc? Without actual comparable output, this discussion isn't much more than warring opinions.</div></div><div class="gmail_quote"><div><br></div><div>Michael</div></div>