minor #15300 [Config] Added caution notice about nested bundle configs (a-menshchikov)

javiereguiluz · javiereguiluz · commit 7172784fb4a7 · 2021-04-30T15:51:04.000+02:00
This PR was merged into the 5.3-dev branch. Discussion ---------- [Config] Added caution notice about nested bundle configs Inspired by a chat with `@Nyholm` Commits ------- 3cceddc Added caution notice about nested bundle configs
diff --git a/configuration.rst b/configuration.rst
@@ -876,7 +876,7 @@ whenever a service/controller defines a ``$projectDir`` argument, use this:
                     // pass this value to any $projectDir argument for any service
                     // that's created in this file (including controller arguments)
                     ->bind('$projectDir', '%kernel.project_dir%');
-            
+
             // ...
         };
 
@@ -953,6 +953,12 @@ namespace ``Symfony\Config``::
         $security->accessControl(['path' => '^/admin', 'roles' => 'ROLE_ADMIN']);
     };
 
+.. caution::
+
+    Note that only "root" classes in the namespace ``Symfony\Config`` are ConfigBuilders.
+    Nested configs (e.g. ``\Symfony\Config\Framework\CacheConfig``) are the Plain Old PHP
+    Objects and cannot be autowired when you specify it as an argument type.
+
 Keep Going!
 -----------
 
