proposal: net/http: clarify behavior of ResponseWriter's Write method

[pkositsyn]

The main question: is it guaranteed that Write method of http.ResponseWriter either returns non-nil error or writes all the data?

If not, then it should be encouraged to use io.Copy(rw, bytes.NewReader(...)). Somehow I'm sure, that a lot of code already relies on full writes and my proposed construction isn't elegant for such boilerplate code

If yes, I would propose to add the guarantee to the comment for Write method

I believe that the guarantee should be provided, because the alternative is unobvious and adds unnecessary boilerplate, opposed to the maintenance of the property

[seankhliao]

it follows the same contract as io.Writer
no need to document it for every instance of Write

[pkositsyn]

@seankhliao I mean it would be great to document it in the interface itself, not every instance of course. This should be a requirement for any implementation even

[pkositsyn]

My bad, this is a guarantee of io.Writer. Sorry for wasting time