Completed JSDoc and improved readability

Using gjslint
See https://developers.google.com/closure/compiler/docs/js-for-compiler