maybe remove JSDoc and create only external documentation

[millermedeiros]

JSDoc add too much noise to the source code and don't add that much benefits.. variable and methods names are pretty straightforward so most of the comments are redundant... maybe refactor code on a way that comments are almost unnecessary.

advantages of jsdocs :

• reduce the chance of the documentation getting outdated (since you remember to update it while you edit the code)..
• having typed annotations helps closure compiler to find errors.. (not that unit tests together with JSLint wouldn't catch it)

disadvantage:

• too much "noise", code gets harder to read.
• most IDEs/editors don't use JSDocs for code completion and/or error checking, making it almost useless during development.
• external documentation is way more flexible, can have more detailed information and better for translation purposes.

[millermedeiros]

probably migrate to joDoc since it have the option to use external markdown files.

[millermedeiros]

I will keep JSDoc since it is already on use and creating an external documentation takes a lot of time...