Minor tweak

javiereguiluz · javiereguiluz · commit 6a55e20d79ed · 2021-04-16T16:00:16.000+02:00
diff --git a/configuration.rst b/configuration.rst
@@ -919,16 +919,20 @@ parameters at once by type-hinting any of its constructor arguments with the
 Using PHP ConfigBuilders
 ------------------------
 
-Writing PHP config is sometimes difficult because you end up with large nested arrays
-and you have no help from your favorite IDE. A way to address this is to use "ConfigBuilders".
-They are objects that will help you build these arrays.
-
 .. versionadded:: 5.3
 
-    The "ConfigBuilders" was added in Symfony 5.3 as an :doc:`experimental feature </contributing/code/experimental>`.
+    The "ConfigBuilders" feature was introduced in Symfony 5.3 as an
+    :doc:`experimental feature </contributing/code/experimental>`.
+
+Writing PHP config is sometimes difficult because you end up with large nested
+arrays and you have no autocompletion help from your favorite IDE. A way to
+address this is to use "ConfigBuilders". They are objects that will help you
+build these arrays.
 
-The ConfigBuilders are automatically generated in your ``kernel.build_dir`` for
-every bundle. By convention they all live in the namespace ``Symfony\Config``.::
+Symfony generates the ConfigBuilder classes automatically in the
+:ref:`kernel build directory <configuration-kernel-build-directory>` for all the
+bundles installed in your application. By convention they all live in the
+namespace ``Symfony\Config``::
 
     // config/packages/security.php
     use Symfony\Config\SecurityConfig;
diff --git a/reference/configuration/kernel.rst b/reference/configuration/kernel.rst
@@ -103,6 +103,8 @@ the :method:`Symfony\\Component\\HttpKernel\\Kernel::getCacheDir` method. To
 change this setting, override the ``getCacheDir()`` method to return the correct
 cache directory.
 
+.. _configuration-kernel-build-directory:
+
 Build Directory
 ~~~~~~~~~~~~~~~
 
@@ -123,7 +125,6 @@ the :method:`Symfony\\Component\\HttpKernel\\Kernel::getBuildDir` method. To
 change this setting, override the ``getBuildDir()`` method to return the correct
 build directory.
 
-
 Log Directory
 ~~~~~~~~~~~~~
 
