[BUG #8181] minor doc fix
[BUG #8181] add more jsdoc comments
[BUG #8181] ignore generated 'api' dir from jsdoc