improved jsdocs