DOC improve documentation of sample_weight, add to docstring.