improve docs for sample