Add documentation clarifying appropriate use of weights in slice_sample()

Add documentation clarifying appropriate use of weights in slice_sample() #1753