updated commenting to use JSDoc style
added toClient notes to README