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_documentatio…
Stephen