updating the jsdoc with new example use cases