-The Framework package is an almost complete drop-in replacement.
+The Framework package is an almost complete drop-in replacement. Note that PSR-7 requests and responses are immutable; to modify them, use the `with*` methods, e.g. `withHeader()`, `withBody()`, `withStatus()`, rather than attempting to change properties in place.

-The whole `Joomla\CMS\Http` package is deprecated in Joomla 6.0 and will be removed in 7.0. Please use the Joomla Framework `Joomla\Http` package instead. The Framework package is an almost complete drop-in replacement. You only have to pay attention when accessing the data from the `Response` object. Don't read from the (magic) attributes, but use the PSR-7 methods instead.
+The whole `Joomla\CMS\Http` package is deprecated in Joomla 6.0 and will be removed in 7.0. Please use the Joomla Framework `Joomla\Http` package instead. The Framework package is an almost complete drop-in replacement. Pay particular attention when accessing data from the `Response` object: do not use magic properties; use PSR-7 methods instead (e.g. `getStatusCode()`, `getReasonPhrase()`, `getHeaders()`, `getHeaderLine('Content-Type')`, and `getBody()->getContents()`).
 
+Example:
+- Before: `$response->code`, `$response->headers`, `$response->body`
+- After: `$response->getStatusCode()`, `$response->getHeaders()`, `(string) $response->getBody()` or `$response->getBody()->getContents()`
+

 Please use the Joomla Framework `Joomla\Http` package instead.
 
+Minimal migration example:
+```
+use Joomla\Http\HttpFactory;
+
+$http = (new HttpFactory())->getHttp();
+$response = $http->get('https://example.com/api');
+
+$status  = $response->getStatusCode();
+$body    = (string) $response->getBody();
+$headers = $response->getHeaders();
+```
+