[florimondmanca]

Fixes #830

Update the documentation on streaming responses (both in the sync and async cases) to indicate how users can clean use the .stream() context manager when block usage via with ... is not possible.

[lovelydinosaur]

I think using AsyncExitStack here is a bit of a hacky work around.

We really want to stear folks away from using stream without a context manager wherever possible, but I'd be okay with us explaining why we do that, but documenting how to do it in the cases where it really is needed. For example...

request = client.build_request(...)
response = client.send(..., stream=True)
try:
    ...
finally:
    response.close()

[florimondmanca]

Closing for now, will need to take another shot at this. :-)