Document ResourceStream close behavior

The underlying PHP resource is shared between the ResourceStream
and the PSR-7 stream, so closing one closes the other. Document
this and suggest copying the stream when reuse is needed.

Author: veewee

docs/transports.md

@@ -41,6 +41,11 @@ This package contains some frequently used encoders / decoders for you:
 | `RawEncoder`            | `EncoderInterface<string>`            | Adds raw string as request body                                                     |
 | `ResourceStreamDecoder` | `DecoderInterface<ResourceStream>`    | Returns `phpro/resource-stream` from response body                                  |
 | `ResourceStreamEncoder` | `EncoderInterface<ResourceStream>`    | Adds `phpro/resource-stream` as request body                                        |
+
+> **Note:** The `ResourceStreamEncoder` passes the underlying PHP resource to a PSR-7 stream.
+> PSR-7's `StreamInterface::close()` will close this resource, which also closes the original `ResourceStream`.
+> If you need to reuse the resource after sending a request, pass a copy of the stream (e.g. via `$stream->copyTo(MemoryStream::create())`) to the encoder instead.
+
 | `ResponseDecoder`       | `DecoderInterface<ResponseInterface>` | Returns the received PSR-7 response as result                                       |
 | `StreamDecoder`         | `DecoderInterface<StreamInterface>`   | Returns the PSR-7 Stream as response result                                         |
 | `StreamEncoder`         | `EncoderInterface<StreamInterface>`   | Adds PSR-7 Stream as request body                                                   |