@param comments #78
Description
Expected Behavior
In Node quickstart, there isn't a comment for what the @param {Object} credentials and other @param is doing. As someone who isn't familiar with what that is (it isn't vanilla node) it took me a while to find that it looks like it's from JSDoc. I don't have experience with a language like C which seems to have similar syntax so I had no idea what that was doing initially. (If anything)
Actual Behavior
It would be great to have an added comment line clarifying these lines of code for those trying to understand the codebase. Something like:
/**
* Create an OAuth2 client with the given credentials, and then execute the
* given callback function.
* @param is a JSDoc tag that provides information about a callback function
* @param {Object} credentials The authorization client credentials.
* @param {function} callback The callback to call with the authorized client.
*/
Specifications
- Node version 10.15.1
- OS Mac