updated docs in prep for jsdoc3 migration