Documentation for client connection hooks should warn against wrapping errors

[rolandshoemaker]

Documentation for the various interface methods that can be hook into the client connection process (i.e. TransportCredentials.ClientHandshake etc) should warn that errors returned from these methods should not be wrapped with an error type that doesn't expose a Temporary method. Doing this can cause relatively hard to debug reconnect behavior.