Merge branch '5.4' into 6.3

* 5.4:
  [Best Practices] Update directory structure
  Document session cookie in response

Author: javiereguiluz

bundles.rst

@@ -94,7 +94,7 @@ to be adjusted if needed:
 
 ``src/``
     Contains all PHP classes related to the bundle logic (e.g. ``Controller/RandomController.php``).
-    
+
 ``config/``
     Houses configuration, including routing configuration (e.g. ``routing.yaml``).
 
@@ -105,13 +105,14 @@ to be adjusted if needed:
     Holds translations organized by domain and locale (e.g. ``AcmeTestBundle.en.xlf``).
 
 ``public/``
-    Contains web assets (images, stylesheets, etc) and is copied or symbolically
-    linked into the project ``public/`` directory via the ``assets:install`` console
-    command.
+    Contains web assets (images, compiled CSS and JavaScript files, etc.) and is
+    copied or symbolically linked into the project ``public/`` directory via the
+    ``assets:install`` console command.
 
 ``assets/``
-    Contains JavaScript, CSS, images and other assets related to the bundle that
-    are not in ``public/`` (e.g. stimulus controllers)
+    Contains the web asset sources (JavaScript and TypeScript files, CSS and Sass
+    files, etc.), images and other assets related to the bundle that are not in
+    ``public/`` (e.g. Stimulus controllers)
 
 ``tests/``
     Holds all tests for the bundle.

bundles/best_practices.rst

@@ -63,6 +63,7 @@ The following is the recommended directory structure of an AcmeBlogBundle:
 .. code-block:: text
 
     <your-bundle>/
+    ├── assets/
     ├── config/
     ├── docs/
     │   └─ index.md
@@ -121,7 +122,8 @@ Doctrine ORM entities                                ``src/Entity/``
 Doctrine ODM documents                               ``src/Document/``
 Event Listeners                                      ``src/EventListener/``
 Configuration (routes, services, etc.)               ``config/``
-Web Assets (CSS, JS, images)                         ``public/``
+Web Assets (compiled CSS and JS, images)             ``public/``
+Web Asset sources (``.scss``, ``.ts``, Stimulus)     ``assets/``
 Translation files                                    ``translations/``
 Validation (when not using annotations)              ``config/validation/``
 Serialization (when not using annotations)           ``config/serialization/``

session.rst

@@ -400,6 +400,15 @@ Check out the Symfony config reference to learn more about the other available
     ``session.auto_start = 1`` This directive should be turned off in
     ``php.ini``, in the web server directives or in ``.htaccess``.
 
+The session cookie is also available in :ref:`the Response object <component-http-foundation-response>`.
+This is useful to get that cookie in the CLI context or when using PHP runners
+like Roadrunner or Swoole.
+
+.. versionadded:: 5.4
+
+    Accessing to the session cookie in the ``Response`` object was introduced
+    in Symfony 5.4.
+
 Session Idle Time/Keep Alive
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~