improved documentation for javascript clients