Yo! I've written a short post on improving JSDocs with typing. It's called "the best documentation automation can buy." If you write JavaScript, you may find it informative. If you're already using this new tooling in your projects, I'd be interested to hear your thoughts as well.
In Grant's words, "Write the docs!"
https://phabricator.wikimedia.org/phame/post/view/194/the_best_documentation...
Stephen