added front end jsdocs