Tweaks

Author: javiereguiluz

reference/configuration/kernel.rst

@@ -88,16 +88,15 @@ method to return the right project directory::
         }
     }
 
-
 Cache Directory
 ~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``$this->getProjectDir()/var/cache/$this->environment``
 
 This returns the absolute path of the cache directory of your Symfony project.
 It's calculated automatically based on the current
-:ref:`environment <configuration-environments>`. Data might be written to this path
-at runtime.
+:ref:`environment <configuration-environments>`. Data might be written to this
+path at runtime.
 
 This value is exposed via the ``kernel.cache_dir`` configuration parameter and
 the :method:`Symfony\\Component\\HttpKernel\\Kernel::getCacheDir` method. To
@@ -115,9 +114,9 @@ Build Directory
 
 This returns the absolute path of a build directory of your Symfony project. This
 directory can be used to separate read-only cache (i.e. the compiled container)
-from read-write cache (i.e. cache pools). Specify a non-default value when the
-application is deployed in a read-only filesystem like a Docker container or AWS
-Lambda.
+from read-write cache (i.e. :doc:`cache pools </cache>`). Specify a non-default
+value when the application is deployed in a read-only filesystem like a Docker
+container or AWS Lambda.
 
 This value is exposed via the ``kernel.build_dir`` configuration parameter and
 the :method:`Symfony\\Component\\HttpKernel\\Kernel::getBuildDir` method. To