Add a few more details to the cluster client docs.
(cherry picked from commit 47f33c9294a80415b25ed74012bbee0bbec694d4)
Merge pull request #1682 from akka/wip-doc-improve-cluster-client-patriknw

Add a few more details to the cluster client docs (backport)