feat(Gruntfile.js and docs): automatic API generation from jsdoc

rough support for jsdoc automatic documentation generation:
* support for AngularJS documentation style
* grunt docs to produce online low level API documentation
* minor edits of some jsdoc in source files