docs: information about ReplicaOrdering needed in load_balancing manual

[sylwiaszunejko]

I would like to report an issue in page: https://github.com/scylladb/java-driver/blob/085dd34ef46b1de5111629bdccfe4056c4355676/manual/load_balancing/README.md

Problem

In TokenAwarePolicy section, there is no mention of the ReplicaOrdering field and when it should be set to ReplicaOrdering.NEUTRAL. This information is covered here:

java-driver/driver-core/src/main/java/com/datastax/driver/core/policies/TokenAwarePolicy.java

Lines 90 to 98 in 085dd34

	/**
	* Return the replicas in the exact same order in which they appear in the child policy's query
	* plan.
	*
	* <p>This is the only strategy that fully respects the child policy's replica ordering. Use it
	* when it is important to keep that order intact (e.g. when using the {@link
	* LatencyAwarePolicy}).
	*/
	NEUTRAL

. Although it states that it is important for the LatencyAwarePolicy, in reality, the RackAwareRoundRobinPolicy also does not function correctly without this option.

Lack of this information in the docs is causing a problem in cassandra-stress (#255), which is currently being addressed by adding ReplicaOrdering.NEUTRAL to the TokenAwarePolicy (scylladb/scylla-tools-java#367).

[fruch]

beside the docs, I think a warning of misuse might be in order...