fix, improve, and validate JSDoc comments

The `"extra": {"class": false}` is necessary due to https://github.com/jscs-dev/jscs-jsdoc/issues/74
To: @hnrch02 for review