Joining member should not be leader, see #3021

* Prefer members with status Up or Leaving, and as
  fallback use Joining, Exiting, Down
* Minor scaladoc fixes
Merge pull request #1227 from akka/wip-3021-leader-status-patriknw

Joining member should not be leader, see #3021