Merge branch '6.4' into 7.0

* 6.4:
  use a release-indepent command to sign the symfony CLI
  fix the Runtime component introduction
  Update runtime.rst
  Minor tweak
  [Frontend] Identify the 2 main approaches to a frontend
  UX bundles: fix autoimport paths
  [AssetMapper] Removing TODOs

Author: OskarStark

components/runtime.rst

@@ -2,8 +2,8 @@ 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,
-    Swoole, etc. without any changes.
+    to make sure the application can run with runtimes like `PHP-PM`_, `ReactPHP`_,
+    `Swoole`_, etc. without any changes.
 
 Installation
 ------------
@@ -468,5 +468,7 @@ The end user will now be able to create front controller like::
         return new SomeCustomPsr15Application();
     };
 
+.. _PHP-PM: https://github.com/php-pm/php-pm
+.. _Swoole: https://openswoole.com/
 .. _ReactPHP: https://reactphp.org/
 .. _`PSR-15`: https://www.php-fig.org/psr/psr-15/

frontend.rst

@@ -1,11 +1,20 @@
 Front-end Tools: Handling CSS & JavaScript
 ==========================================
 
-Symfony gives you the flexibility to choose any front-end tools you want. This could
-be dead-simple - like putting CSS & JS directly in the ``public/`` directory - or
-more advanced - like scaffolding your front-end with a tool like Next.js.
+Symfony gives you the flexibility to choose any front-end tools you want. There
+are generally two approaches:
 
-However, Symfony *does* come with two powerful options to help you build a modern,
+#. :ref:`building your HTML with PHP & Twig <frontend-twig-php>`;
+#. :ref:`building your frontend with a JavaScript framework <frontend-js>` like React.
+
+Both work great - and are discussed below.
+
+.. _frontend-twig-php:
+
+Using PHP & Twig
+----------------
+
+Symfony comes with two powerful options to help you build a modern,
 fast frontend, *and* enjoy the process:
 
 * :ref:`AssetMapper <frontend-asset-mapper>` (recommended for new projects) runs
@@ -39,7 +48,7 @@ be executed by a browser.
 .. _frontend-asset-mapper:
 
 AssetMapper (Recommended)
--------------------------
+~~~~~~~~~~~~~~~~~~~~~~~~~
 
 AssetMapper is the recommended system for handling your assets. It runs entirely
 in PHP with *no* complex build step or dependencies. It does this by leveraging
@@ -51,7 +60,7 @@ to a polyfill.
 .. _frontend-webpack-encore:
 
 Webpack Encore
---------------
+~~~~~~~~~~~~~~
 
 .. screencast::
 
@@ -65,7 +74,7 @@ asset system that's a *delight* to use.
 :doc:`Read the Encore Documentation </frontend/encore/index>`
 
 Stimulus & Symfony UX Components
---------------------------------
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Once you've installed AssetMapper or Encore, it's time to start building your
 front-end. You can write your JavaScript however you want, but we recommend
@@ -74,6 +83,18 @@ using `Stimulus`_, `Turbo`_ and a set of tools called `Symfony UX`_.
 To learn about Stimulus & the UX Components, see:
 the `StimulusBundle Documentation`_
 
+.. _frontend-js:
+
+Using a Front-end Framework (React, Vue, Svelte, etc)
+-----------------------------------------------------
+
+If you want to use a front-end framework (Next.js, React, Vue, Svelte, etc),
+we recommend using their native tools and using Symfony as a pure API. A wonderful
+tool to do that is `API Platform`_. Their standard distribution comes with a
+Symfony-powered API backend, frontend scaffolding in Next.js (other frameworks
+are also supported) and a React admin interface. It comes fully Dockerized and even
+contains a web server.
+
 Other Front-End Articles
 ------------------------
 
@@ -89,3 +110,4 @@ Other Front-End Articles
 .. _Stimulus: https://stimulus.hotwired.dev/
 .. _Turbo: https://turbo.hotwired.dev/
 .. _Symfony UX: https://ux.symfony.com
+.. _API Platform: https://api-platform.com/

frontend/asset_mapper.rst

@@ -958,10 +958,6 @@ rendered by the ``{{ importmap() }}`` Twig function:
 Page-Specific CSS & JavaScript
 ------------------------------
 
----> TODO HEre
----> need to add the entrypoint in the importmap.php file
-----> and should NOT call parent() in the javascript block
-
 Sometimes you may choose to include CSS or JavaScript files only on certain
 pages. For JavaScript, an easy way is to load the file with a `dynamic import`_:
 

frontend/create_ux_bundle.rst

@@ -48,8 +48,8 @@ of packages in ``importmap`` should be the same as the ones in ``peerDependencie
                     "fetch": "eager",
                     "enabled": true,
                     "autoimport": {
-                        "dist/bootstrap4-theme.css": false,
-                        "dist/bootstrap5-theme.css": true
+                        "@acme/feature/dist/bootstrap4-theme.css": false,
+                        "@acme/feature/dist/bootstrap5-theme.css": true
                     }
                 }
             },

setup/symfony_server.rst

@@ -65,11 +65,7 @@ run the Symfony server in the background:
 
     .. code-block:: terminal
 
-        # find the installed version of the Symfony binary
-        $ symfony version
-
-        # change the path to the location of your Symfony binary and replace {version} too
-        $ sudo codesign --force --deep --sign - /opt/homebrew/Cellar/symfony-cli/{version}/bin/symfony
+        $ sudo codesign --force --deep --sign - $(whereis -q symfony)
 
 Enabling PHP-FPM
 ----------------