Tweaks

javiereguiluz · javiereguiluz · commit 912d988beee8 · 2024-09-19T16:46:01.000+02:00
diff --git a/web_link.rst b/web_link.rst
@@ -59,6 +59,8 @@ correct prioritization and the content security policy:
 
     <head>
         <!-- ... -->
+        {# note that you must add two <link> tags per asset:
+           one to link to it and the other one to tell the browser to preload it #}
         <link rel="preload" href="{{ preload('/app.css', {as: 'style'}) }}" as="style">
         <link rel="stylesheet" href="/app.css">
     </head>
@@ -67,6 +69,13 @@ If you reload the page, the perceived performance will improve because the
 server responded with both the HTML page and the CSS file when the browser only
 requested the HTML page.
 
+.. tip::
+
+    When using the :doc:`AssetMapper component </frontend/asset_mapper>` to link
+    to assets (e.g. ``importmap('app')``), there's no need to add the ``<link rel="preload">``
+    tag. The ``importmap()`` Twig function automatically adds the ``Link`` HTTP
+    header for you when the WebLink component is available.
+
 .. note::
 
     You can preload an asset by wrapping it with the ``preload()`` function:
