Enhance documentation

[urbantumbleweed]

The plugin needs some better documentation. Could use jdocs to better describe the api.

[phated]

Don't use JSDoc, they are going to need to be handwritten in the README