Rebase and reapply fixes

Tiriel · Tiriel · commit 83ec70261e13 · 2023-04-20T13:40:26.000+02:00
diff --git a/http_client.rst b/http_client.rst
@@ -731,7 +731,7 @@ The ``RetryableHttpClient`` uses a
 decide if the request should be retried, and to define the waiting time between
 each retry.
 
-Retry over different URIs
+Retry Over Different URIs
 .........................
 
 .. versionadded:: 6.3
@@ -747,21 +747,21 @@ request::
         'base_uri' => [
             // first request will use this base URI
             'http://example.com/a/',
-            // if first request fails, this second base URI will be used
+            // if first request fails, the following base URI will be used
             'http://example.com/b/',
         ],
     ]);
 
 When the number of retries is higher than the number of base URIs, the 
-last base URI will be used for remaining retries.
+last base URI will be used for the remaining retries.
 
 If you want to shuffle the order of base URIs for each retry attempt, nest the
 base URIs you want to shuffle in an additional array::
 
     $response = $client->request('GET', 'foo-bar', [
         'base_uri' => [
             [
-                // this array will be randomized
+                // a single random URI from this array will be used for the first request
                 'http://example.com/a/',
                 'http://example.com/b/',
             ],
