First draft of new rebalancing documentation.
Updated javadoc.
Addressed review feedback for rebalance doc.