Update README.rst
promoted MIN_SAMPLES to a constructor parameter
added docs
merged