added comments in English and updated documentation jsdoc