Tweaks

Author: javiereguiluz

bundles.rst

@@ -84,7 +84,7 @@ between all Symfony bundles. It follows a set of conventions, but is flexible
 to be adjusted if needed:
 
 ``Controller/``
-    Contains the controllers of the bundle (e.g. ``RandomController.php``).
+    the controllers of the bundle (e.g. ``RandomController.php``).
 
 ``DependencyInjection/``
     Holds certain Dependency Injection Extension classes, which may import service
@@ -98,9 +98,9 @@ to be adjusted if needed:
     Holds templates organized by controller name (e.g. ``Random/index.html.twig``).
 
 ``Resources/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 nad JavaScript files, etc.) and is
+    copied or symbolically linked into the project ``public/`` directory via the
+    ``assets:install`` console command.
 
 ``Tests/``
     Holds all tests for the bundle.

bundles/best_practices.rst

@@ -122,8 +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 not meant to be publicly available        ``assets/``
+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/``