renamed weight to sample_weight in sklearn/isotonic.py

I ended up making the change all throughout the file to remain consistent.
A few other minor edits were done for pep8.
See Issue #2041 for reasoning.

I didn't address the "iterable" issue in the documentation, I'll leave that for someone more senior to decide.