[MRG+1] Correct documentation about Response parameters

[thomdixon]

This fixes issue #2196

[codecov-io]

Current coverage is 83.40% (diff: 100%)

Merging #2197 into master will increase coverage by 0.01%

Powered by Codecov. Last update cacd038...f68dc30

[kmike]

Nice catch, thanks @thomdixon!

[eliasdorneles]

This is a good fix, thanks.

An even better fix will be to move these docs to docstrings in the code and use autodocs here, but that can be done in a follow-up.
I've been meaning to do that for a while since #713 and this gives me more motivation to get back on it -- so double thanks.