better jsdoc for Dorsal

I've done some work on the jsdoc part of dorsal codebase and then I ran `jsdoc-parse src/dorsal.js|dmd` to get https://github.com/eventbrite/dorsal/wiki/API-definition.