Document the `Response.reason` attribute.

Made `.status_code` and `.reason` consistent with one another, adding some examples. Addresses #1225.