reformatted web cache resolver documentation additions

Author: robfrawley

Resources/doc/cache-resolver/web_path.rst

@@ -5,18 +5,21 @@ Web Path Resolver
 =================
 
 The ``WebPathResolver`` resolver enabled cache resolution using the
-web path of your application.
-The resulting web path is computed by taking into account the request context,
-notably to decide which scheme to use. If you use a proxy to decrypt incoming
-TLS traffic, and need the resolver to generate https urls, you will need to
-`list trusted proxies in the configuration of the framework`_. If you also
-`embed controllers`_ in your templates, you will need to add the localhost to
-that list.
-The request context is also used to determine the port to specify, should it
-differ from standard HTTP ports like ports 80 or 443.
-
-.. _`list trusted proxies in the configuration of the framework`: https://symfony.com/doc/current/request/load_balancer_reverse_proxy.html
-.. _`embed controllers`: https://symfony.com/doc/current/templating/embedding_controllers.html
+web path of your application. The resulting web path is computed by
+taking a number of factors into account, including the `request context`_
+as provided by the Symfony HTTP kernel.
+
+.. tip::
+
+    The request context is most notably used to determine the HTTP scheme
+    prepended to the final URL. If you use a proxy to offload TLS traffic
+    decryption and need the resolver to generate HTTPS URLS, you will need
+    to configure Symfony's `trusted proxies`_ appropriately. If you
+    `embed controllers`_ in your templates, ``localhost`` must be added to
+    your trusted proxy configuration.
+
+    The request context is also used to determine the port to specify,
+    should it differ from the standard HTTP/HTTPS (80/443) ports.
 
 
 Configuration
@@ -75,3 +78,8 @@ filter set using the following configuration.
                 cache: profile_photos
                 filters:
                     # the filter list
+
+
+.. _`request context`: http://symfony.com/doc/current/components/http_foundation.html#request
+.. _`trusted proxies`: https://symfony.com/doc/current/request/load_balancer_reverse_proxy.html#solution-trusted-proxies
+.. _`embed controllers`: https://symfony.com/doc/current/templating/embedding_controllers.html