added method comments / jsdocs