Amendments to first pass JSDocs

I have combined @aadsm’s and @asolove’s patches for the JSDocs into a `jsdoc` branch so that you may review the changes I’m proposing atop your work. I’ll then merge `jsdoc-amend` into `jsdoc` and `jsdoc` then into `master`.