Improve JSDoc usage

Change tag usage to more accurately describe the API, and include
external examples from the Miso project website.