jshint / jsdoc syntax fixes; add jsdoc-conf.json; explore jdoc way to ge...

...nerate useful documentation

### Problem
jsdoc generation of html failed.

### Solution
fix bugs for jsdoc; explore pattern for documenting / indexing classes / angular constructs.