Improve JSDoc usage

Change tag usage to more accurately describe the API, and include
external examples from the Miso project website.
Merge branch 'jugglinmike-jsdoc'