Add missing API jsdoc tags

[Robert Flaherty]

I started running into missing types, and having them is more helpful then having to look into the source. I don't know what kind of tool is generating the docs, and what validation can be achieved, like:

• missing/mismatched @param count and names; I see Object gets spit out by default, so I assume there is some intelligent parsing of the parameters
• missing @returns when body has return statement; this may be hard given nested classes

Anyway, I did a regexp search for methods in the SDK output that would have return types ((?:get|is|has|find|create|exists)
w*).

[Marek Lewandowski]

@rflahert thanks for the feedback. We're using JSDuck for docs (you'll find information on it ​in our docs).

There are some mismatched places, actually thanks for a valuable log! I checked couple of methods and those might use some improvements.

Can I ask you what tool has been used for creating a log like this?

[Robert Flaherty]

I wrote a quick file scanner and regexp matcher in Java. I assume you guys look for Javascriptbased tools. If its' useful I can upload it. Hooking in to JSDuck or submitting error detection to them is probably the better route.