Cluster client connection discovery issues

[dylanwilder]

The documentation currently claims:

1. /connection returns json of the form { "nodes": [...]}. It actually returns an object of the form {"address": [ip:port ..], "dns": [dns:port]} EDIT: turns out this is discussed twice, once correctly
2. clients using the java client should connect using the addContactPointsWithPorts() builder method. This is incorrect. Clients should us addContactPoints() to supply hosts and withPort() to provide a unique port for the cluster

I also propose as part of this ticket to update the connection endpoint to return two new fields "port" and "hosts" - potentially deprecating the old fields - which will facilitate easier use for most cassandra client services. Thoughts?

[dylanwilder]

I can send a PR for this if no one objects.

[nickbp]

That'd be great, feel free to send a PR. It sounds like the docs just fell out of date.