Move http_client.retry_failed config inside retry_failed section

See issue #21434

Before:

framework.http_client.max_retries

After:

framework.http_client.retry_failed.max_retries

I am not sure if this is the proper way, as I did not see other sections in the framework config with this level of nesting.

Author: hellomedia

reference/configuration/framework.rst

@@ -1024,25 +1024,6 @@ The minimum version of TLS to accept. The value must be one of the
 
     The ``crypto_method`` option was introduced in Symfony 6.3.
 
-.. _reference-http-client-retry-delay:
-
-delay
-.....
-
-**type**: ``integer`` **default**: ``1000``
-
-The initial delay in milliseconds used to compute the waiting time between retries.
-
-.. _reference-http-client-retry-enabled:
-
-enabled
-.......
-
-**type**: ``boolean`` **default**: ``false``
-
-Whether to enable the support for retry failed HTTP request or not.
-This setting is automatically set to true when one of the child settings is configured.
-
 extra
 .....
 
@@ -1065,15 +1046,6 @@ headers
 An associative array of the HTTP headers added before making the request. This
 value must use the format ``['header-name' => 'value0, value1, ...']``.
 
-.. _reference-http-client-retry-http-codes:
-
-http_codes
-..........
-
-**type**: ``array`` **default**: :method:`Symfony\\Component\\HttpClient\\Retry\\GenericRetryStrategy::DEFAULT_RETRY_STATUS_CODES`
-
-The list of HTTP status codes that triggers a retry of the request.
-
 http_version
 ............
 
@@ -1082,18 +1054,6 @@ http_version
 The HTTP version to use, typically ``'1.1'``  or ``'2.0'``. Leave it to ``null``
 to let Symfony select the best version automatically.
 
-.. _reference-http-client-retry-jitter:
-
-jitter
-......
-
-**type**: ``float`` **default**: ``0.1`` (must be between 0.0 and 1.0)
-
-This option adds some randomness to the delay. It's useful to avoid sending
-multiple requests to the server at the exact same time. The randomness is
-calculated as ``delay * jitter``. For example: if delay is ``1000ms`` and jitter
-is ``0.2``, the actual delay will be a number between ``800`` and ``1200`` (1000 +/- 20%).
-
 local_cert
 ..........
 
@@ -1111,16 +1071,6 @@ local_pk
 The path of a file that contains the `PEM formatted`_ private key of the
 certificate defined in the ``local_cert`` option.
 
-.. _reference-http-client-retry-max-delay:
-
-max_delay
-.........
-
-**type**: ``integer`` **default**: ``0``
-
-The maximum amount of milliseconds initial to wait between retries.
-Use ``0`` to not limit the duration.
-
 max_duration
 ............
 
@@ -1149,26 +1099,6 @@ max_redirects
 The maximum number of redirects to follow. Use ``0`` to not follow any
 redirection.
 
-.. _reference-http-client-retry-max-retries:
-
-max_retries
-...........
-
-**type**: ``integer`` **default**: ``3``
-
-The maximum number of retries for failing requests. When the maximum is reached,
-the client returns the last received response.
-
-.. _reference-http-client-retry-multiplier:
-
-multiplier
-..........
-
-**type**: ``float`` **default**: ``2``
-
-This value is multiplied to the delay each time a retry occurs, to distribute
-retries in time instead of making all of them sequentially.
-
 no_proxy
 ........
 
@@ -1239,6 +1169,7 @@ This option configures the behavior of the HTTP client when some request fails,
 including which types of requests to retry and how many times. The behavior is
 defined with the following options:
 
+* :ref:`retry_strategy <reference-http-client-retry-retry-strategy>`
 * :ref:`delay <reference-http-client-retry-delay>`
 * :ref:`http_codes <reference-http-client-retry-http-codes>`
 * :ref:`jitter <reference-http-client-retry-jitter>`
@@ -1272,8 +1203,20 @@ defined with the following options:
                     retry_failed:
                         max_retries: 4
 
+.. _reference-http-client-retry-enabled:
+
+enabled
+"""""""
+
+**type**: ``boolean`` **default**: ``false``
+
+Whether to enable the support for retry failed HTTP request or not.
+This setting is automatically set to true when one of the child settings is configured.
+
+.. _reference-http-client-retry-retry-strategy:
+
 retry_strategy
-..............
+""""""""""""""
 
 **type**: ``string``
 
@@ -1284,6 +1227,66 @@ with ``http_codes``, ``delay``, ``max_delay``, ``multiplier`` and ``jitter``
 options. This class has to implement
 :class:`Symfony\\Component\\HttpClient\\Retry\\RetryStrategyInterface`.
 
+.. _reference-http-client-retry-http-codes:
+
+http_codes
+""""""""""
+
+**type**: ``array`` **default**: :method:`Symfony\\Component\\HttpClient\\Retry\\GenericRetryStrategy::DEFAULT_RETRY_STATUS_CODES`
+
+The list of HTTP status codes that triggers a retry of the request.
+
+.. _reference-http-client-retry-delay:
+
+delay
+"""""
+
+**type**: ``integer`` **default**: ``1000``
+
+The initial delay in milliseconds used to compute the waiting time between retries.
+
+.. _reference-http-client-retry-jitter:
+
+jitter
+""""""
+
+**type**: ``float`` **default**: ``0.1`` (must be between 0.0 and 1.0)
+
+This option adds some randomness to the delay. It's useful to avoid sending
+multiple requests to the server at the exact same time. The randomness is
+calculated as ``delay * jitter``. For example: if delay is ``1000ms`` and jitter
+is ``0.2``, the actual delay will be a number between ``800`` and ``1200`` (1000 +/- 20%).
+
+.. _reference-http-client-retry-max-delay:
+
+max_delay
+"""""""""
+
+**type**: ``integer`` **default**: ``0``
+
+The maximum amount of milliseconds initial to wait between retries.
+Use ``0`` to not limit the duration.
+
+.. _reference-http-client-retry-max-retries:
+
+max_retries
+"""""""""""
+
+**type**: ``integer`` **default**: ``3``
+
+The maximum number of retries for failing requests. When the maximum is reached,
+the client returns the last received response.
+
+.. _reference-http-client-retry-multiplier:
+
+multiplier
+"""""""""
+
+**type**: ``float`` **default**: ``2``
+
+This value is multiplied to the delay each time a retry occurs, to distribute
+retries in time instead of making all of them sequentially.
+
 scope
 .....