First round of reviews

Author: javiereguiluz

reference/configuration/twig.rst

@@ -343,8 +343,8 @@ the directory defined in the :ref:`default_path option <config-twig-default-path
         twig:
             # ...
             paths:
-                '%kernel.project_dir%/email/default/templates': ~
-                '%kernel.project_dir%/backend': 'admin'
+                'email/default/templates': ~
+                'backend/templates': 'admin'
 
     .. code-block:: xml
 
@@ -358,8 +358,8 @@ the directory defined in the :ref:`default_path option <config-twig-default-path
 
             <twig:config>
                 <!-- ... -->
-                <twig:path>%kernel.project_dir%/email/default/templates</twig:path>
-                <twig:path namespace="admin">%kernel.project_dir%/backend</twig:path>
+                <twig:path>email/default/templates</twig:path>
+                <twig:path namespace="admin">backend/templates</twig:path>
             </twig:config>
         </container>
 
@@ -369,8 +369,8 @@ the directory defined in the :ref:`default_path option <config-twig-default-path
         $container->loadFromExtension('twig', [
             // ...
             'paths' => [
-                '%kernel.project_dir%/email/default/templates' => null,
-                '%kernel.project_dir%/backend' => 'admin',
+                'email/default/templates' => null,
+                'backend/templates' => 'admin',
             ],
         ]);
 

reference/twig_reference.rst

@@ -81,6 +81,8 @@ Returns an instance of ``ControllerReference`` to be used with functions
 like :ref:`render() <reference-twig-function-render>` and
 :ref:`render_esi() <reference-twig-function-render-esi>`.
 
+.. _reference-twig-function-asset:
+
 asset
 ~~~~~
 
@@ -102,7 +104,7 @@ Symfony provides various cache busting implementations via the
 :ref:`reference-framework-assets-version`, :ref:`reference-assets-version-strategy`,
 and :ref:`reference-assets-json-manifest-path` configuration options.
 
-.. seelaso::
+.. seealso::
 
     Read more about :ref:`linking to web assets from templates <templates-link-to-assets>`.
 
@@ -235,17 +237,9 @@ absolute_url
 ``path``
     **type**: ``string``
 
-Returns the absolute URL from the passed relative path. For example, assume
-you're on the following page in your app:
-``http://example.com/products/hover-board``.
-
-.. code-block:: twig
-
-    {{ absolute_url('/human.txt') }}
-    {# http://example.com/human.txt #}
-
-    {{ absolute_url('products_icon.png') }}
-    {# http://example.com/products/products_icon.png #}
+Returns the absolute URL from the passed relative path. Combine it with the
+:ref:`asset() function <reference-twig-function-asset>` to generate absolute URLs
+for web assets. Read more about :ref:`Linking to CSS, JavaScript and Image Assets <templates-link-to-assets>`.
 
 relative_path
 ~~~~~~~~~~~~~