Fixup documentation (typos / google-jsdoc syntax / missing params)

Also added nicer formatting here and there.