a few more jsdocs