Mention `ready` in the docs for `connect` (dart-lang/web_socket_channel#287)

Closes dart-lang/web_socket_channel#280

There can be confusion when there are errors creating the channel
because the only wait to catch them is to include an `await
channel.ready` in the try block. Mention that `ready` can complete as an
error in the case of connection failure.