Merge branch '5.4' into 6.2

* 5.4:
  Use Doctor RST 1.41.0 and new rule `TitleUnderlineLengthMustMatchTitleLength`

Author: OskarStark

.doctor-rst.yaml

@@ -47,6 +47,7 @@ rules:
     space_between_label_and_link_in_doc: ~
     space_between_label_and_link_in_ref: ~
     string_replacement: ~
+    title_underline_length_must_match_title_length: ~
     typo: ~
     unused_links: ~
     use_deprecated_directive_instead_of_versionadded: ~

.github/workflows/ci.yaml

@@ -73,7 +73,7 @@ jobs:
                     key: ${{ runner.os }}-doctor-rst-${{ steps.extract_base_branch.outputs.branch }}
 
             -   name: "Run DOCtor-RST"
-                uses: docker://oskarstark/doctor-rst:1.40.1
+                uses: docker://oskarstark/doctor-rst:1.41.0
                 with:
                     args: --short --error-format=github --cache-file=/github/workspace/.cache/doctor-rst.cache
 

best_practices.rst

@@ -229,7 +229,7 @@ important parts of your application.
 .. _best-practice-controller-annotations:
 
 Use Attributes or Annotations to Configure Routing, Caching, and Security
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Using attributes or annotations for routing, caching, and security simplifies
 configuration. You don't need to browse several files created with different
@@ -437,7 +437,7 @@ specific tests for each page.
 .. _hardcode-urls-in-a-functional-test:
 
 Hard-code URLs in a Functional Test
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 In Symfony applications, it's recommended to :ref:`generate URLs <routing-generating-urls>`
 using routes to automatically update all links when a URL changes. However, if a

components/lock.rst

@@ -70,7 +70,7 @@ method can be safely called repeatedly, even if the lock is already acquired.
     third argument of the ``createLock()`` method to ``false``.
 
 Serializing Locks
-------------------
+-----------------
 
 The :class:`Symfony\\Component\\Lock\\Key` contains the state of the
 :class:`Symfony\\Component\\Lock\\Lock` and can be serialized. This

components/runtime.rst

@@ -3,7 +3,7 @@
    single: Components; Runtime
 
 The Runtime Component
-======================
+=====================
 
     The Runtime Component decouples the bootstrapping logic from any global state
     to make sure the application can run with runtimes like PHP-PM, ReactPHP,

components/serializer.rst

@@ -1000,7 +1000,7 @@ context to pass in these options using the key ``json_encode_options`` or
     $this->serializer->serialize($data, 'json', ['json_encode_options' => \JSON_PRESERVE_ZERO_FRACTION]);
 
 The ``CsvEncoder``
-~~~~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~~
 
 The ``CsvEncoder`` encodes to and decodes from CSV.
 

controller.rst

@@ -19,7 +19,7 @@ to render the content of a page.
    single: Controller; Basic example
 
 A Basic Controller
--------------------
+------------------
 
 While a controller can be any PHP callable (function, method on an object,
 or a ``Closure``), a controller is usually a method inside a controller

frontend/encore/bootstrap.rst

@@ -74,7 +74,7 @@ Now, require bootstrap from any of your JavaScript files:
     });
 
 Using Bootstrap with Turbo
----------------------------
+--------------------------
 
 If you are using bootstrap with Turbo Drive, to allow your JavaScript to load on each page change,
 wrap the initialization in a ``turbo:load`` event listener:

frontend/encore/virtual-machine.rst

@@ -93,7 +93,7 @@ connections:
     otherwise other computers can have access to it.
 
 Fix "Invalid Host header" Issue
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Webpack will respond ``Invalid Host header`` when trying to access files from
 the dev-server. To fix this, set the ``allowedHosts`` option:

mercure.rst

@@ -614,7 +614,7 @@ Checkout `the dedicated API Platform documentation`_ to learn more about
 its Mercure support.
 
 Testing
---------
+-------
 
 During unit testing it's usually not needed to send updates to Mercure.
 

reference/configuration/framework.rst

@@ -1193,7 +1193,7 @@ The value of this option is an associative array of ``domain => IP address``
 (e.g ``['symfony.com' => '46.137.106.254', ...]``).
 
 retry_strategy
-...............
+..............
 
 **type**: ``string``
 

reference/configuration/security.rst

@@ -313,7 +313,7 @@ If ``true``, users are always redirected to the default target path regardless
 of the previous URL that was stored in the session.
 
 default_target_path
-....................
+...................
 
 **type**: ``string`` **default**: ``/``
 

reference/forms/types/choice.rst

@@ -313,7 +313,7 @@ Field Variables
     faster to use the :ref:`selectedchoice <form-twig-selectedchoice>` test.
 
 Accessing Form Choice Data
-...........................
+..........................
 
 The ``form.vars`` variable of each choice entry holds data such as whether the
 choice is selected or not. If you need to get the full list of choices data and

reference/forms/types/tel.rst

@@ -2,7 +2,7 @@
    single: Forms; Fields; TelType
 
 TelType Field
-===============
+=============
 
 The ``TelType`` field is a text field that is rendered using the HTML5
 ``<input type="tel">`` tag. Following the recommended HTML5 behavior, the value

reference/twig_reference.rst

@@ -127,7 +127,7 @@ and :ref:`reference-assets-json-manifest-path` configuration options.
     Read more about :ref:`linking to web assets from templates <templates-link-to-assets>`.
 
 asset_version
-~~~~~~~~~~~~~~
+~~~~~~~~~~~~~
 
 .. code-block:: twig