symfony
diff --git a/‎setup.rst
Copy file name to clipboardExpand all lines: setup.rst
-15Lines changed: 0 additions & 15 deletions b/‎setup.rst
Copy file name to clipboardExpand all lines: setup.rst
-15Lines changed: 0 additions & 15 deletions
diff --git a/‎setup/upgrade_major.rst
Copy file name to clipboardExpand all lines: setup/upgrade_major.rst
+31-9Lines changed: 31 additions & 9 deletions b/‎setup/upgrade_major.rst
Copy file name to clipboardExpand all lines: setup/upgrade_major.rst
+31-9Lines changed: 31 additions & 9 deletions
@@ -281,19 +281,6 @@ create new projects. If you use Composer, you need to tell the exact version:
 
     $ composer create-project symfony/skeleton:"6.4.*" my_project_directory
 
-With an already existing project, you can restrict Symfony packages to one
-specific version by :doc:`using Symfony Flex in your project </setup/flex>`
-and setting the ``extra.symfony.require`` config:
-
-.. code-block:: terminal
-
-    $ composer config extra.symfony.require "6.4.*"
-
-.. warning::
-
-    Tools like `dependabot`_ may ignore this setting and upgrade the Symfony dependencies,
-    see this `GitHub issue about dependabot`_.
-
 The Symfony Demo application
 ----------------------------
 
@@ -328,8 +315,6 @@ Learn More
 .. _`Install Composer`: https://getcomposer.org/download/
 .. _`install the Symfony CLI`: https://symfony.com/download
 .. _`symfony-cli/symfony-cli GitHub repository`: https://github.com/symfony-cli/symfony-cli
-.. _`dependabot`: https://docs.github.com/en/code-security/dependabot
-.. _`GitHub issue about dependabot`: https://github.com/dependabot/dependabot-core/issues/4631
 .. _`The Symfony Demo Application`: https://github.com/symfony/demo
 .. _`Symfony Flex`: https://github.com/symfony/flex
 .. _`PHP security advisories database`: https://github.com/FriendsOfPHP/security-advisories
 
@@ -162,20 +162,40 @@ starting with ``symfony/`` to the new major version:
           "...": "...",
       }
 
-At the bottom of your ``composer.json`` file, in the ``extra`` block you can
-find a data setting for the Symfony version. Make sure to also upgrade
-this one. For instance, update it to ``6.0.*`` to upgrade to Symfony 6.0:
+A more efficient way to handle Symfony dependency updates is by setting the
+``extra.symfony.require`` configuration option in your ``composer.json`` file.
+In Symfony applications using :doc:`Symfony Flex </setup/flex>`, this setting
+restricts Symfony packages to a single specific version, improving both
+dependency management and Composer update performance:
 
 .. code-block:: diff
 
-      "extra": {
-          "symfony": {
-              "allow-contrib": false,
-    -         "require": "5.4.*"
-    +         "require": "6.0.*"
-          }
+      {
+          "...": "...",
+
+          "require": {
+    -         "symfony/cache": "6.0.*",
+    +         "symfony/cache": "*",
+    -         "symfony/config": "6.0.*",
+    +         "symfony/config": "*",
+    -         "symfony/console": "6.0.*",
+    +         "symfony/console": "*",
+              "...": "...",
+          },
+          "...": "...",
+
+    +     "extra": {
+    +         "symfony": {
+    +             "require": "6.0.*"
+    +         }
+    +     }
       }
 
+.. warning::
+
+    Tools like `dependabot`_ may ignore this setting and upgrade Symfony
+    dependencies. For more details, see this `GitHub issue about dependabot`_.
+
 .. tip::
 
     If a more recent minor version is available (e.g. ``6.4``) you can use that
@@ -338,3 +358,5 @@ Classes in the ``vendor/`` directory are always ignored.
 .. _`PHP CS Fixer`: https://github.com/friendsofphp/php-cs-fixer
 .. _`Rector`: https://github.com/rectorphp/rector
 .. _`maintained Symfony versions`: https://symfony.com/releases
+.. _`dependabot`: https://docs.github.com/en/code-security/dependabot
+.. _`GitHub issue about dependabot`: https://github.com/dependabot/dependabot-core/issues/4631