I got sick of using JSDoc3 in one of my personal projects, so I made my own: http://blog.kodewerx.org/2014/05/trials-of-documenting-javascript-source.html
Even if we don't use that, we should definitely replace JSDoc3 with something better. This has been a problem forever, and mentioned a few times in #66.