I think this comment can be made much more concise, without as much redundancy with the `Parameters` section. For example, "The data is resampled and optionally shuffled to produce a specific class distribution (use `method` or `proba`) and number of samples (use `scale`, `n_samples`, `method='undersample'` or `method='oversample'`)." says most of what you need to say here.