add jsdocs to fix warnings