added comments + sample jsdocs