This is a great doc comment on the algorithm but I'd move it to the `PartitionCoalescer` class to put it closer to the code. In `CoalescedRDD` you can just say it tries to take into account both locality and load-balancing.