infrastructure updates
improve jsdocs