update docs for sampling