more comments part of jsdocs updates