improve jsdoc a tiny bit
updating markdown doc