ENYO-2276: Added jsdoc and took into account review comments

Enyo-DCO-1.1-Signed-off-by: Yves Del Medico <yves.del-medico@hp.com>