clarify up front that it can also do dynamic partitioning
more doc tweaks, call out that when passing 50% of the last partition it may create more than one additional