Document the `Response.reason` attribute.

Made `.status_code` and `.reason` consistent with one another, adding some examples. Addresses #1225.
Merge pull request #1904 from mjpieters/doc-response-reason

Document the `Response.reason` attribute.